bankrbot/delu-oracle

delu-oracle

Intelligence layer for any Base trading agent. Pass one Base EVM contract address (or cashtag like $BNKR) and get back a flat decision header an agent can act on in a single hop — action, conviction, entry/stop/size, and a one-line delu-voiced read — with the full cognition report underneath for the why.

Scout, auditor, and quant run server-side on every call. The full observed block is always present. Social signal (checkr) is opt-in via ?social=true.

Endpoint

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

Base is the only supported chain — no chain parameter needed.

Parameters

| Parameter | Location | Required | Notes | |---|---|---|---| | ca | path | yes | 0x-prefixed EVM address or cashtag / symbol (e.g. $BNKR, BNKR). Ambiguous symbols return a 400 asking for the CA directly. | | social | query | no | ?social=true enables checkr social enrichment (+$0.45 USDC, billed to caller) | | verbose | query | no | Accepted but no-op — observed and summary are always present. |

⚠️ Sequential calls required

Do not call this endpoint in parallel. The x402 upto scheme uses a single-use Permit2 signature per authorization. Parallel calls with the same payer wallet result in 402 Payment could not be verified on all but the first.

Always call sequentially — one CA at a time, await the full response, then call the next.

// ✅ 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)));

The decision header — read this first

Flat, no traversal needed:

"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"
}

Simple gate: decision.action === "ENTER" && decision.conviction >= 70 && confidence >= 0.6

action maps from verdict: strong_buy/buy → ENTER, hold → WATCH, avoid/drop → AVOID.

WATCH mandate — null position fields

When verdict is hold, all position-specific fields are null in both decision and mandate — entry_low, entry_high, stop, size_pct, entry_zone, stop_loss, stop_basis, size_hint_pct, size_basis. Only horizon and invalidations are populated.

Payment tier

The endpoint uses the upto scheme — agents sign for the 250k DELU ceiling, but the handler settles based on the caller's DELU balance on Base.

| Tier | Balance | Settled | |---|---|---| | whale | 100M+ DELU | 0 DELU (free) | | holder | 50M+ DELU | 50,000 DELU | | public | < 50M DELU | 250,000 DELU |

Payment token: DELU — 0x7b0ee9dcb5c1d4d7cd630c652959951936512ba3 on Base (18 decimals).

Check payment_tier.settled_delu in the response body for what was actually charged — not the x402 authorization ceiling.

Response schema summary

• decision — flat header: action, conviction, direction, entry_low, entry_high, stop, size_pct, read
• ca, chain, oracle_version
• verdict — strong_buy | buy | hold | avoid | drop
• score — 0–100 fused cognition score
• confidence — 0–1 data quality and signal agreement
• drivers / risks — up to 3 each
• 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 — always present: market, regime, social, deluagent (scout/auditor/quant mirror with weights_used)
• summary, selected_timeframe, candle_count, pool_source, timestamp

See references/response-schema.md for the full field-by-field schema. See references/mandate-fields.md for mandate construction details. See references/example-response.md for a full annotated response example. See references/social-enrichment.md for the opt-in two-step social flow. See references/external-clients.md for standalone client recipes.

Error codes

| Status | Meaning | |---|---| | 400 | Bad ca, symbol not found on Base, ambiguous symbol, or no supported Base pair | | 402 | Payment required or failed. 402 Payment could not be verified on retry = parallel calls — switch to sequential | | 404 | Unknown token or no reportable data | | 5xx | Oracle or upstream failure — retry later |