{"uid":"cap_rPYUc9PMKyUYqobUaIKyW","slug":"hyperliquid-open-interest-positioning-signal-27440d4c","name":"Hyperliquid 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/hyperliquid/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_0dhaVLYJF4oL_0jR1uAut","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, long/short ratios, liquidations, taker flow, and a crowding verdict for a given crypto perpetual on Hyperliquid and OKX","exampleAgentPrompt":"What's the current open interest and positioning situation for ETH perps — is there any crowding extreme or deleveraging signal I should know about right now?","exampleUseCases":[{"title":"Detect BTC long crowding before trade","prompt":"Check if BTC perps are crowded with longs right now — give me the long/short ratio, crowding score, and whether it's a good idea to fade the positioning."},{"title":"Monitor ETH deleveraging signals","prompt":"Has ETH open interest dropped significantly in the last 4 hours, and are there heavy long liquidations that might suggest deleveraging is happening?"},{"title":"Assess SOL funding and taker flow","prompt":"Pull the latest open interest data for SOL including the taker buy/sell ratio and funding rates — I want to know if the market is positioned heavily one way."}],"resultDescription":"A JSON object containing: coin identifier, open interest in USD (Hyperliquid and OKX, with 1h/4h/24h % changes), long/short ratio (current, 24h change, 48h percentile), liquidation breakdown by 1h/4h/24h windows with dominant side and USD amounts, taker flow buy/sell ratios, funding rates (OKX and Hyperliquid APR), a numeric crowding_score, a categorical verdict (e.g. BALANCED), a human-readable action recommendation, list of reason strings, and suggested next endpoint calls.","failureModes":["Unknown coin symbol returns 400 or empty data","Payment of 0.003 USDC via x402 not included returns 402 Payment Required","Hyperliquid or OKX upstream data temporarily unavailable causes stale or partial response","Very low-liquidity coins may return null or zero values for some fields","Rate limiting if payment is not processed correctly"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a real-time, multi-venue view of crypto perpetual market positioning — specifically open interest levels, liquidation cascades, taker flow direction, and crowding signals — without needing to aggregate raw data from Hyperliquid and OKX separately. It is especially valuable when deciding whether to fade or follow a crowded position, or when detecting signs of deleveraging. No API key required; pay-per-call via x402 USDC microtransaction makes it suitable for autonomous agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:04.117Z","isFirstParty":false,"canonicalSlug":"hyperliquid-open-interest-positioning-signal-27440d4c"}