{"uid":"cap_vCfoEIcJ011UKxKnRAY9V","slug":"crypto-open-interest-positioning-signal-f709452d","name":"Crypto Open Interest & Positioning Signal","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/v1/open-interest?utm_source=zero.xyz","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","properties":{"coin":{"type":"string","examples":["BTC","ETH","SOL"],"maxLength":12,"description":"Perp coin, e.g. BTC, ETH, SOL, DOGE (alias symbol=; default BTC)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coin":"BTC","next":["/crypto/funding-signal?coin=BTC","/crypto/candles?symbol=BTC&interval=1h","/crypto/hl-book?coin=BTC"],"action":"No crowding extreme; positioning is not a reason to fade or follow.","funding":{"okx_8h_pct":0.0053,"okx_apr_pct":5.76,"hyperliquid_apr_pct":10.95},"reasons":["OI -3.9% in 4h: deleveraging","4h liquidations: longs $2900k vs shorts $310k (longs_liquidated)","4h taker buy/sell 0.87"],"verdict":"BALANCED","taker_flow":{"1h":{"buy_usd":213069948,"sell_usd":267061837,"buy_sell_ratio":0.798}},"updated_at":"2026-10-30T08:40:00Z","liquidations":{"1h":{"count":38,"dominant":"longs_liquidated","long_liq_usd":1250000,"short_liq_usd":40000},"4h":{"count":90,"dominant":"longs_liquidated","long_liq_usd":2900000,"short_liq_usd":310000},"24h":{"count":100,"dominant":"longs_liquidated","long_liq_usd":2900000,"short_liq_usd":310000},"venue":"okx","sample_covers_minutes":230},"open_interest":{"okx_usd":2579936287,"total_usd":4979936287,"change_1h_pct":-2.11,"change_4h_pct":-3.9,"change_24h_pct":1.2,"hyperliquid_usd":2400000000},"crowding_score":0,"long_short_ratio":{"max_48h":2.72,"min_48h":1.69,"long_pct":69.1,"change_24h":0.49,"okx_accounts":2.24,"ratio_24h_ago":1.75,"percentile_48h":53}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gzWGTN2veZPn4N8FFuUyx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns open interest levels, liquidation data, taker flow, long/short ratios, and a crowding verdict for a given perp coin across OKX and Hyperliquid.","exampleAgentPrompt":"Check the open interest and positioning signal for ETH perps — I want to know if there's a crowding extreme, how OI has changed in the last 4 hours, and whether longs or shorts are getting wrecked more.","exampleUseCases":[{"title":"Pre-trade crowding check for perp trade","prompt":"Before I go long on SOL perps, check if there's a crowding extreme — show me the open interest trend, long/short ratio, and whether the positioning verdict says to fade or follow."},{"title":"Liquidation cascade monitoring for BTC","prompt":"What does the liquidation data look like for BTC over the last 4 hours? I want to know how much in longs vs shorts got wiped and what the taker flow ratio is."},{"title":"Funding rate and OI comparison across venues","prompt":"Give me the current funding rates for ETH on both OKX and Hyperliquid, and tell me how total open interest has changed over the last 24 hours."}],"resultDescription":"Returns a JSON object with: open interest in USD (OKX + Hyperliquid + total), OI change % at 1h/4h/24h windows, liquidation counts and USD sizes broken down by longs vs shorts at 1h/4h/24h, taker buy/sell ratio and USD volumes, long/short ratio with 48h percentile and 24h change, funding rates (OKX and Hyperliquid APR), a numeric crowding score, a BALANCED/CROWDED_LONG/CROWDED_SHORT verdict, a human-readable action recommendation, and links to related endpoints.","failureModes":["Invalid or unsupported coin symbol returns error or empty result","Payment not completed (x402 flow failure) results in 402 response with no data","Stale data if upstream OKX or Hyperliquid APIs are delayed","Missing query param defaults to BTC — may return unexpected coin data if caller omits coin"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a structured, pre-computed positioning signal rather than raw order book data. It is ideal for pre-trade crowding checks, liquidation cascade monitoring, and funding rate comparison across venues in a single call. Prefer it over raw exchange APIs when you want an opinionated verdict (BALANCED, CROWDED_LONG, CROWDED_SHORT) plus multi-venue aggregation without managing exchange credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:17.165Z","isFirstParty":false,"canonicalSlug":"crypto-open-interest-positioning-signal-f709452d"}