delu-oracle

Couche d'intelligence pour tout agent de trading Base. Passe une adresse de contrat EVM Base (ou un cashtag comme $BNKR) et récupère un header decision plat sur lequel un agent peut agir en un seul passage — action, conviction, entry/stop/size, et une read en voix delu d'une ligne — avec le rapport de cognition complet en dessous pour expliquer pourquoi.

Scout, auditor, et quant s'exécutent côté serveur à chaque appel. Le bloc observed complet est toujours présent. Le signal social (checkr) est optionnel via ?social=true.

Endpoint

GET https://x402.bankr.bot/0xed2ceca9de162c4f2337d7c1ab44ee9c427709da/delu-oracle/analyze/{ca}

Base est la seule chaîne supportée — aucun paramètre chain n'est nécessaire.

Paramètres

⚠️ Appels séquentiels requis

N'appelez pas cet endpoint en parallèle. Le schéma upto de x402 utilise une signature Permit2 à usage unique par autorisation. Les appels parallèles avec le même wallet payeur entraînent un 402 Payment could not be verified sur tous sauf le premier.

Appelez toujours séquentiellement — une CA à la fois, attendez la réponse complète, puis appelez la suivante.

// ✅ correct
for (const ca of watchlist) {
  const result = await oracle.analyze(ca);
  process(result);
}

// ❌ wrong
const results = await Promise.all(watchlist.map(ca => oracle.analyze(ca)));

Le header de décision — lisez ceci en premier

Plat, aucune traversée nécessaire :

"decision": {
  "action": "ENTER",       // ENTER | WATCH | AVOID
  "conviction": 71,        // 0-100
  "direction": "long",
  "entry_low": 0.00051,
  "entry_high": 0.00053,
  "stop": 0.00048,
  "size_pct": 3.1,
  "read": "one line, delu voice"
}

Garde simple : decision.action === "ENTER" && decision.conviction >= 70 && confidence >= 0.6

action est issu de verdict : strong_buy/buy → ENTER, hold → WATCH, avoid/drop → AVOID.

Mandat WATCH — champs de position null

Quand verdict est hold, tous les champs spécifiques à la position sont null dans decision et mandate — entry_low, entry_high, stop, size_pct, entry_zone, stop_loss, stop_basis, size_hint_pct, size_basis. Seuls horizon et invalidations sont remplis.

Tier de paiement

L'endpoint utilise le schéma upto — les agents signent pour le plafond DELU de 250k, mais le handler règle en fonction du solde DELU de l'appelant sur Base.

Token de paiement : DELU — 0x7b0ee9dcb5c1d4d7cd630c652959951936512ba3 sur Base (18 décimales).

Vérifiez payment_tier.settled_delu dans le corps de la réponse pour savoir ce qui a été réellement facturé — non le plafond d'autorisation x402.

Résumé du schéma de réponse

• decision — header plat : action, conviction, direction, entry_low, entry_high, stop, size_pct, read
• ca, chain, oracle_version
• verdict — strong_buy | buy | hold | avoid | drop
• score — score de cognition fusionné 0–100
• confidence — 0–1 qualité des données et accord des signaux
• drivers / risks — jusqu'à 3 chacun
• signals — momentum, flow, structure, volatility, liquidity
• context — regime_label, regime_confidence, base_eco_pulse, macro_pulse
• mandate — action, entry_zone, stop_loss, stop_basis, size_hint_pct, size_basis, horizon, invalidations
• payment_tier — tier, delu_balance, settled_delu, note
• observed — toujours présent : market, regime, social, deluagent (miroir scout/auditor/quant avec weights_used)
• summary, selected_timeframe, candle_count, pool_source, timestamp

Voir references/response-schema.md pour le schéma complet champ par champ. Voir references/mandate-fields.md pour les détails de construction du mandat. Voir references/example-response.md pour un exemple de réponse complet annoté. Voir references/social-enrichment.md pour le flux social optionnel en deux étapes. Voir references/external-clients.md pour les recettes de client autonome.

Codes d'erreur