{"uid":"cap_pWmYZ6OV-W7rvTo-eVfR_","slug":"coinglass-open-interest-positioning-signal-24505957","name":"Coinglass 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/coinglass/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_g52VDALzn__Hk3ylZz9qq","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 aggregated open interest, liquidations, taker flow, long/short ratio, and a crowding verdict for a given perpetual futures coin via Coinglass data.","exampleAgentPrompt":"Pull the open interest and liquidation crowding signal for BTC perps — I want to know if longs are getting wrecked and whether positioning is extreme enough to fade.","exampleUseCases":[{"title":"Pre-trade crowding check for BTC long","prompt":"Before I open a BTC long, check if the market is overcrowded on the long side — give me the open interest change over the last 4 hours, the liquidation breakdown, and the overall crowding verdict."},{"title":"ETH positioning snapshot for risk management","prompt":"What does the current ETH perp positioning look like? I need the long/short ratio, how it's changed in the last 24 hours, and whether taker flow is bullish or bearish."},{"title":"SOL funding rate and OI momentum scan","prompt":"Give me the latest open interest momentum and funding rates for SOL across OKX and Hyperliquid — I want to know if there's been meaningful deleveraging in the last 4 hours."}],"resultDescription":"Returns a JSON object containing: open interest in USD for OKX and Hyperliquid with 1h/4h/24h percentage changes; liquidation counts and USD values for longs and shorts across 1h/4h/24h windows; taker buy/sell flow ratios; long/short ratio with 48h percentile context; funding rates (OKX 8h % and APR, Hyperliquid APR); a numeric crowding score; a BALANCED/CROWDED verdict string; human-readable reasons array; an actionable signal sentence; and suggested next endpoints to call.","failureModes":["Invalid or unsupported coin symbol returns error or empty data","Payment failure (insufficient USDC balance or x402 protocol error) blocks the call","Upstream Coinglass data outage may result in stale or missing fields","Rate limiting or worker capacity issues on the Cloudflare Workers host","Malformed query parameter (symbol too long) may be rejected by schema validation"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a synthesized, opinionated positioning signal combining open interest, liquidations, taker flow, and long/short ratio in a single call — rather than assembling these from multiple raw exchange APIs. Ideal for pre-trade risk checks, crowding detection, and funding-rate arbitrage scanning. Prefer over generic market data APIs when you want a pre-computed verdict and actionable summary without API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:30.533Z","isFirstParty":false,"canonicalSlug":"coinglass-open-interest-positioning-signal-24505957"}