{"uid":"cap_F3vG9hz0e7dYS_Gi8rZcC","slug":"crypto-open-interest-positioning-signal-a7ff1b9c","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/api/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_VzqGY94NIUAeN5rvbeqvw","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, long/short ratio, liquidation data, taker flow, and a crowding verdict for a given perp coin across OKX and Hyperliquid","exampleAgentPrompt":"What's the current open interest and positioning signal for ETH perps — are there any crowding extremes or heavy liquidations I should know about before I trade?","exampleUseCases":[{"title":"Pre-trade positioning check for BTC","prompt":"Before I open a long on BTC perps, tell me the current open interest, long/short ratio, and whether there's any crowding extreme or heavy liquidation signal I should be aware of."},{"title":"SOL deleveraging alert for trading bot","prompt":"Check the open interest and liquidation data for SOL over the last 4 hours — has there been significant deleveraging, and is taker flow confirming it?"},{"title":"Hyperliquid vs OKX OI comparison for ETH","prompt":"How does the open interest on Hyperliquid compare to OKX for ETH right now, and what's the overall crowding verdict?"}],"resultDescription":"Returns a JSON object with: open interest in USD for OKX and Hyperliquid plus a total, OI percentage change over 1h/4h/24h, long/short ratio (current, 24h ago, 48h percentile), liquidation counts and USD by dominant side for 1h/4h/24h, taker buy/sell flow in USD and ratio for 1h, funding rates from OKX (8h % and APR) and Hyperliquid (APR), a numeric crowding_score, a verdict string (e.g. BALANCED), a plain-English action recommendation, human-readable reasons, and a next-steps array of related endpoints to call.","failureModes":["Unknown coin symbol returns an error or default BTC data","Upstream OKX or Hyperliquid data unavailable may cause stale or partial response","Payment not fulfilled (x402 flow incomplete) returns 402 Payment Required","Malformed query parameter (coin too long >12 chars) rejected by schema validation","Rate or quota issues at upstream data providers may delay response"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a fast, single-call synthesis of derivatives market positioning — specifically open interest trends, liquidation activity, and taker flow — across OKX and Hyperliquid for a given perp coin. Prefer this over raw exchange APIs when you need a pre-digested crowding verdict and action signal without API keys, paying only $0.003 USDC per call via x402 on Base. Best suited for agents that need to assess whether current positioning is a reason to fade or follow a directional move.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:56.457Z","isFirstParty":false,"canonicalSlug":"crypto-open-interest-positioning-signal-f709452d"}