{"uid":"cap__BFCqxAp0GsyX3xjwQ00r","slug":"acoda-market-state-cex-liquidation-hyperliquid-perp-intelligence-85cc02d6","name":"ACODA Market State — CEX Liquidation & Hyperliquid Perp Intelligence","description":"Measured liquidation intelligence combining observed CEX liquidation events with position-level data from Hyperliquid, the largest transparent perp venue. A pay-per-call JSON API for AI trading agents.","url":"https://acoda.xyz/v1/market-state","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"market":{"enum":["BTC-USDT-PERP","ETH-USDT-PERP","SOL-USDT-PERP"],"type":"string","description":"Perp market (canonical BASE-QUOTE-PERP)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"paid":true,"market":"BTC-USDT-PERP","freshness":{"stale":false,"age_ms":426},"mark_price":63514.07,"funding_rate":0.0000759,"open_interest_usd":21441257752.13,"exchange_breakdown":{"binance":{"weight":0.32,"markPrice":63514.77}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F32bQyYNIuP94oruDmHU7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time perp market state including mark price, funding rate, open interest, and multi-exchange liquidation data for BTC, ETH, or SOL perpetual markets","exampleAgentPrompt":"Pull the current market state for BTC-USDT-PERP — I want the mark price, funding rate, open interest, and how fresh the data is.","exampleUseCases":[{"title":"Pre-trade funding rate check","prompt":"Before I open a long on ETH perps, check the current funding rate and open interest on ETH-USDT-PERP so I know if longs are crowded."},{"title":"Liquidation-aware BTC position sizing","prompt":"I'm about to size into a BTC short — can you pull the current BTC-USDT-PERP market state including open interest and any liquidation signals so I can gauge crowding?"},{"title":"Real-time SOL perp market monitor","prompt":"Every few minutes, fetch the SOL-USDT-PERP market state and alert me if the funding rate spikes above 0.01% or open interest drops by more than 5%."}],"resultDescription":"A JSON object containing: payment confirmation (paid: true), the queried market symbol, data freshness metadata (stale flag and age in milliseconds), current mark price in USD, funding rate, total open interest in USD, and an exchange breakdown showing each CEX's contribution weight and mark price (e.g. Binance at 0.32 weight).","failureModes":["Invalid or unsupported market symbol returns an error — only BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP are accepted","Payment not included or insufficient USDC (x402 flow) results in 402 Payment Required","Stale data flag (stale: true) may be returned if upstream Hyperliquid or CEX feeds are delayed","Network timeout if the aggregation layer is slow to collect multi-exchange data","Rate limiting if too many calls are made in rapid succession without proper payment"],"whenToPreferThis":"Choose this endpoint when your AI trading agent needs a single, aggregated view of perpetual market state that combines transparent on-chain Hyperliquid position data with CEX liquidation signals. It is ideal for pre-trade checks, position sizing decisions, funding rate arbitrage signals, or real-time market monitoring workflows. Prefer it over raw exchange APIs when you want pre-normalized, multi-source mark price and open interest data in one pay-per-call call without managing multiple WebSocket connections.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:53.934Z","isFirstParty":false}