{"uid":"cap_xNBHebluAMUiQ6miGZwsB","slug":"crypto-liquidation-positioning-signal-x402-249cfbff","name":"Crypto Liquidation & Positioning Signal (x402)","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/intervals?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_fwJNff93leBCU7e-h23h6","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 real-time liquidation intervals, open interest, taker flow, long/short ratios, funding rates, and a crowding verdict for a given crypto perp coin","exampleAgentPrompt":"What's the current liquidation signal for BTC — are longs or shorts getting wrecked, how crowded is positioning, and what's the funding rate verdict right now?","exampleUseCases":[{"title":"Long squeeze detection for BTC","prompt":"Check BTC perp liquidations and taker flow over the last 4 hours — are longs getting liquidated heavily, and is OI dropping? I want to know if there's a long squeeze in progress."},{"title":"Funding rate and crowding check before trade","prompt":"Before I open an ETH long, can you pull the current crowding score, long/short ratio percentile, and funding rates on OKX and Hyperliquid so I know if I'd be fighting overcrowded positioning?"},{"title":"Multi-coin positioning scan for trading bot","prompt":"Pull the liquidation verdict and crowding signal for SOL perps — I need to know if positioning is extreme enough to fade or if it's balanced, and what the taker buy/sell ratio looks like."}],"resultDescription":"A JSON object containing: liquidation data broken into 1h/4h/24h windows (count, dominant side, long/short USD liquidated), open interest in USD for OKX and Hyperliquid with % changes, taker flow buy/sell ratios, long/short ratio with 48h percentile, funding rates (OKX 8h % and APR, Hyperliquid APR), a crowding_score, a VERDICT string (e.g. BALANCED), a human-readable action recommendation, an array of reasons, and suggested next endpoint calls.","failureModes":["Invalid or unsupported coin symbol returns an error or empty response","Payment failure via x402 if USDC balance on Base is insufficient","Stale data if upstream OKX or Hyperliquid feeds are delayed (check updated_at field)","Rate limit or worker timeout on high-traffic periods","Missing short-window data if liquidation sample_covers_minutes is less than the requested interval"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a consolidated liquidation + positioning + funding signal in a single call rather than stitching together raw exchange feeds. It is purpose-built for agentic workflows via x402 micropayments with no API key setup, making it ideal for autonomous agents that need real-time perp market structure data on BTC, ETH, SOL, or DOGE before entering or exiting positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:48.599Z","isFirstParty":false,"canonicalSlug":"crypto-liquidation-positioning-signal-x402-249cfbff"}