{"uid":"cap_Au5iMs5ddyx1JioGG-cxt","slug":"crypto-perpetuals-liquidation-positioning-signal-9ccba48f","name":"Crypto Perpetuals Liquidation & 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/v1/coinank/liquidation/agg-history?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_DtIjo9izYP-d8LSPVSazA","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 liquidation history, open interest, taker flow, funding rates, and a crowding verdict for a given perpetuals coin (e.g. BTC, ETH, SOL).","exampleAgentPrompt":"What's the current liquidation and crowding signal for BTC perps — are longs or shorts getting wrecked, and is there a positioning extreme I should be aware of?","exampleUseCases":[{"title":"Detect long squeeze before entry","prompt":"Before I go long on ETH perps, check the liquidation data for ETH — how much long liquidation has happened in the last 4 hours and is open interest falling? I want to know if I'd be buying into a forced selling event."},{"title":"Funding rate arbitrage check","prompt":"Compare the funding rate for BTC on OKX and Hyperliquid right now — I want to know the APR spread so I can decide which venue to short-fund on."},{"title":"Monitor crowding extremes for fade trade","prompt":"Give me the crowding score and long/short ratio percentile for SOL perps — I'm looking for a positioning extreme where the crowd is leaning too hard one way so I can fade it."}],"resultDescription":"A JSON object containing: liquidation counts and USD volumes by side (longs vs shorts) for 1h/4h/24h windows; open interest in USD for OKX, Hyperliquid, and total with % changes; long/short ratio with 48h min/max/percentile; taker buy/sell flow ratios; funding rates (OKX 8h%, OKX APR%, Hyperliquid APR%); a crowding_score; a human-readable verdict (e.g. BALANCED); an action recommendation string; and reasons list explaining the signal. Also includes suggested next endpoints to call.","failureModes":["Unknown or unsupported coin symbol returns an error or empty result","Stale data if upstream OKX or Hyperliquid feeds are delayed","Payment failure via x402 if USDC balance on Base is insufficient","Rate limiting if too many calls are made in rapid succession","Missing fields for coins with low OI on one venue (e.g. Hyperliquid OI may be null for small-cap coins)"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a synthesized, multi-venue view of perpetuals positioning for a specific coin — combining liquidation cascades, open interest momentum, taker flow, and funding rates into a single actionable signal. Prefer this over raw exchange APIs when you want a pre-computed crowding verdict and action recommendation without writing aggregation logic. Ideal for agents that need to make entry/exit decisions based on derivatives market structure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:26.501Z","isFirstParty":false,"canonicalSlug":"crypto-perpetuals-liquidation-positioning-signal-9ccba48f"}