{"uid":"cap_g-upkx-RvRO_7vfDupPEA","slug":"crypto-oi-aggregate-kline-crowding-signal-6b32537a","name":"Crypto OI Aggregate Kline / Crowding 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/v1/coinank/oi/agg-kline?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_OLQoktqTvL3tuISzB8u2l","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 perpetual futures coin across major venues (OKX, Hyperliquid).","exampleAgentPrompt":"Is BTC currently crowded on the long side? Give me the open interest changes, liquidation breakdown, taker flow, and funding rates across OKX and Hyperliquid, and tell me whether positioning is a reason to fade or follow.","exampleUseCases":[{"title":"Pre-trade crowding check for a perp trade","prompt":"Before I open a long on ETH perps, can you check if the market is already crowded long — show me the OI trend, recent liquidations, and the crowding verdict so I know if I'm fighting the positioning?"},{"title":"Funding rate arbitrage scanner","prompt":"What are the current funding rates for SOL on OKX and Hyperliquid, and is open interest rising or falling? I want to see if there's a funding premium worth capturing."},{"title":"Liquidation cascade alert for a trading bot","prompt":"Pull the latest liquidation data for BTC perps — how many longs vs shorts got wiped in the last 1h and 4h, and what's the taker sell pressure looking like right now?"}],"resultDescription":"Returns a JSON object with: crowding verdict (BALANCED, CROWDED_LONG, CROWDED_SHORT, etc.), crowding score, action recommendation text, reasons array, open interest in USD across OKX and Hyperliquid with 1h/4h/24h % changes, liquidation counts and USD values by side for 1h/4h/24h, taker buy/sell flow ratios, long/short ratio with 48h min/max/percentile, funding rates for OKX and Hyperliquid (8h % and APR), timestamp, and suggested follow-on endpoints.","failureModes":["Missing or invalid coin symbol returns an error or defaults to BTC","Data may be delayed if upstream venue API (OKX, Hyperliquid) is unavailable","Payment failure via x402 (insufficient USDC on Base) results in 402 response before data is returned","Rate limits or worker timeouts may return 503 for high-traffic periods","Very low-cap coins not listed on OKX perps may return empty or partial fields"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a consolidated crowding/positioning signal for crypto perpetual futures — combining OI, liquidations, taker flow, and long/short ratio in one call rather than querying multiple exchange APIs separately. Ideal for pre-trade positioning checks, funding arb scanning, or risk management in autonomous trading bots. Prefer over raw exchange APIs when you need a pre-computed verdict and don't want to implement your own aggregation logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:53.087Z","isFirstParty":false,"canonicalSlug":"crypto-oi-aggregate-kline-crowding-signal-6b32537a"}