{"uid":"cap_O3Xr8xvB0687XMT0RkvvP","slug":"hyperliquid-liquidations-crowding-signal-e38a4f5e","name":"Hyperliquid Liquidations & 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/hyperliquid/node/liquidations?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_G7I8JybihMVrH2p6kz81w","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 per-coin liquidation data, open interest, taker flow, long/short ratio, funding rates, and a crowding verdict for a perpetuals market coin on Hyperliquid/OKX","exampleAgentPrompt":"Pull the latest liquidation and crowding signal for BTC perps — I want to see how many longs vs shorts got liquidated in the last 4 hours, the open interest change, and whether the market is in a crowding extreme.","exampleUseCases":[{"title":"Detect long squeeze before shorting","prompt":"Check if BTC longs are getting heavily liquidated right now and whether the crowding score suggests the long trade is overcrowded — I'm thinking about opening a short."},{"title":"Monitor ETH open interest shift","prompt":"What's the open interest change for ETH perps over the last 4 hours on Hyperliquid, and is taker flow leaning toward sellers?"},{"title":"Scan SOL for liquidation cascade risk","prompt":"Is there an unusual spike in SOL liquidations in the past hour compared to normal, and what's the current long/short ratio telling us about positioning?"}],"resultDescription":"A JSON object containing: per-timeframe (1h/4h/24h) liquidation counts, dominant side, and USD volumes for longs and shorts; open interest totals for OKX and Hyperliquid with percentage changes; taker buy/sell flow ratios; long/short ratio with 48h min/max/percentile; funding APR from OKX and Hyperliquid; a crowding_score; a human-readable verdict (e.g. BALANCED); an action recommendation string; and suggested next API calls.","failureModes":["Invalid or unsupported coin symbol returns an error or empty data","Upstream Hyperliquid/OKX data unavailable causes stale or missing fields","Missing USDC payment via x402 returns HTTP 402 Payment Required","Rate limiting if payment is not processed correctly","Coin parameter exceeding maxLength of 12 characters is rejected"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a composite derivatives market-structure signal for a specific coin — combining liquidations, open interest, taker flow, funding, and crowding into a single decision-ready payload. Prefer this over raw exchange APIs when you want an aggregated, pre-interpreted verdict without managing multiple upstream connections or API keys. Ideal for agents that need to assess whether a trade is crowded or a liquidation cascade is underway before executing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:06.349Z","isFirstParty":false,"canonicalSlug":"hyperliquid-liquidations-crowding-signal-e38a4f5e"}