{"openapi":"3.1.0","info":{"title":"ACODA — Agentic Cross-venue Observed Data Analytics","version":"1.0.0","description":"Liquidation intelligence for AI trading agents, paid per call in USDC over x402 on Base mainnet. The observed map is MEASURED — real liquidation prices read from live Hyperliquid positions — not modeled. Aggregates Binance, OKX, Bybit, BitMEX, Gate, HTX and Hyperliquid.","x-guidance":"No account or API key. Call any paid GET endpoint; you receive HTTP 402 with a USDC price quote (payTo included); sign an EIP-3009 authorization (gasless), retry with the payment header, and get JSON back. Flagship: GET /v1/observed-map?market=BTC-USDT-PERP ($0.10) — real, exchange-reported liquidation levels bucketed by price with disclosed coverage. Cheaper routes: /v1/market-state and /v1/agent/brief ($0.01), /v1/liquidations/recent ($0.02), /v1/zones and /v1/heatmap ($0.05). Free preview at /v1/public/overview. Markets: BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP. Full catalog also at /llms.txt.","contact":{"email":"hello@acoda.xyz","url":"https://acoda.xyz"}},"servers":[{"url":"https://acoda.xyz"}],"paths":{"/v1/agent/brief":{"get":{"operationId":"agentBrief","summary":"One-call agent brief: current market state, observed liquidation flow in the last hour, and the nearest estimated liquid","description":"One-call agent brief: current market state, observed liquidation flow in the last hour, and the nearest estimated liquidation zone — as compact text + numbers.","tags":["crypto","liquidations","perps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"market","in":"query","required":false,"description":"Perp market (canonical BASE-QUOTE-PERP)","schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"paid":true,"market":"BTC-USDT-PERP","summary":"BTC-USDT-PERP mark 63514. Funding positive (longs pay). Last hour: 14 liquidations totaling $4.9M.","nearest_zone":{"side":"long","price_low":61800,"price_high":62400}}}}},"402":{"description":"Payment Required"}}}},"/v1/market-state":{"get":{"operationId":"marketState","summary":"Aggregated perp market state: OI-weighted mark/index price, open interest, funding, per-venue breakdown and freshness ac","description":"Aggregated perp market state: OI-weighted mark/index price, open interest, funding, per-venue breakdown and freshness across 7 live venues.","tags":["crypto","liquidations","perps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"market","in":"query","required":false,"description":"Perp market (canonical BASE-QUOTE-PERP)","schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"paid":true,"market":"BTC-USDT-PERP","mark_price":63514.07,"open_interest_usd":21441257752.13,"funding_rate":0.0000759,"exchange_breakdown":{"binance":{"markPrice":63514.77,"weight":0.32}},"freshness":{"age_ms":426,"stale":false}}}}},"402":{"description":"Payment Required"}}}},"/v1/liquidations/recent":{"get":{"operationId":"liquidationsRecent","summary":"Recently observed liquidation events across Binance, OKX, Bybit, BitMEX, Gate and HTX — normalized to one schema (venue-","description":"Recently observed liquidation events across Binance, OKX, Bybit, BitMEX, Gate and HTX — normalized to one schema (venue-throttled feeds; an honest floor, not a total).","tags":["crypto","liquidations","perps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"market","in":"query","required":false,"description":"Perp market (canonical BASE-QUOTE-PERP)","schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}},{"name":"limit","in":"query","required":false,"description":"Max events (default 100)","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"paid":true,"market":"BTC-USDT-PERP","liquidations":[{"exchange":"okx","side":"SELL","liquidated_position":"long","price":63297.9,"quantity_base":0.53,"notional_usd":33547.89,"event_time_ms":1786546838548}]}}}},"402":{"description":"Payment Required"}}}},"/v1/zones":{"get":{"operationId":"zones","summary":"Estimated liquidation zones (model v1) with confidence scoring and full model-component transparency, blended from obser","description":"Estimated liquidation zones (model v1) with confidence scoring and full model-component transparency, blended from observed liquidation flow across venues.","tags":["crypto","liquidations","perps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"market","in":"query","required":false,"description":"Perp market (canonical BASE-QUOTE-PERP)","schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"paid":true,"market":"BTC-USDT-PERP","model_version":"liq-zones-v1","zones":[{"side":"long","price_low":61800,"price_high":62400,"intensity":0.9}],"confidence":0.62}}}},"402":{"description":"Payment Required"}}}},"/v1/heatmap":{"get":{"operationId":"heatmap","summary":"Liquidation heatmap as pure JSON: price×time intensity grid weighted by real open-interest deltas. The data a CoinGlass-","description":"Liquidation heatmap as pure JSON: price×time intensity grid weighted by real open-interest deltas. The data a CoinGlass-style heatmap renders from, for agents with no eyes.","tags":["crypto","liquidations","perps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"market","in":"query","required":false,"description":"Perp market (canonical BASE-QUOTE-PERP)","schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}},{"name":"window_hours","in":"query","required":false,"description":"Lookback window in hours (default 24)","schema":{"type":"string"}},{"name":"price_buckets","in":"query","required":false,"description":"Price buckets (default 40)","schema":{"type":"string"}},{"name":"time_buckets","in":"query","required":false,"description":"Time buckets (default 24)","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"paid":true,"market":"BTC-USDT-PERP","model_version":"liq-heatmap-v2.1","mark_price":63490.11,"grid":[{"t_ms":1786500000000,"cells":[{"price_low":62000,"price_high":62500,"intensity":0.8}]}]}}}},"402":{"description":"Payment Required"}}}},"/v1/observed-map":{"get":{"operationId":"observedMap","summary":"MEASURED liquidation map: real liquidation prices read from live Hyperliquid positions (the exchange-reported liquidatio","description":"MEASURED liquidation map: real liquidation prices read from live Hyperliquid positions (the exchange-reported liquidationPx of open positions), bucketed by price. A sampled lower bound with explicit coverage — observed, not modeled.","tags":["crypto","liquidations","perps"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"market","in":"query","required":false,"description":"Perp market (canonical BASE-QUOTE-PERP)","schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}},{"name":"price_buckets","in":"query","required":false,"description":"Price buckets (default 40)","schema":{"type":"string"}},{"name":"range_pct","in":"query","required":false,"description":"Half-range around mark in percent (default 15)","schema":{"type":"string"}}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"},"example":{"paid":true,"market":"BTC-USDT-PERP","source":"observed","basis":"exchange-reported liquidationPx of open positions","mark_price":63490.11,"price_axis":{"min":53966.59,"max":73013.62,"buckets":40,"bucket_width":476.18},"cells":[{"price_low":62243.79,"price_high":62878.93,"long_notional_usd":4712345.1,"short_notional_usd":0,"position_count":27,"intensity":1}],"coverage":{"complete":false,"note":"Sampled lower bound; coverage disclosed."}}}}},"402":{"description":"Payment Required"}}}},"/v1/public/overview":{"get":{"operationId":"publicOverview","summary":"Free reduced-resolution preview: market state, coarse observed map, recent liquidations","tags":["crypto","liquidations","perps"],"parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/track-record":{"get":{"operationId":"trackRecord","summary":"Public forward-logged liquidation-cluster calls scored hit/miss (misses included)","tags":["crypto","liquidations","perps"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Max rows (default 25)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/health":{"get":{"operationId":"health","summary":"Service, venue freshness, and payment-layer status","tags":["crypto","liquidations","perps"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/markets":{"get":{"operationId":"markets","summary":"Supported markets","tags":["crypto","liquidations","perps"],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}