{"uid":"cap_rEGDBdFcwFYu-bjAVFaji","slug":"crypto-liquidations-positioning-signal-coinglass-via-x402-9767ede6","name":"Crypto Liquidations & Positioning Signal (Coinglass via 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/coinglass/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_wBnF78K53-kaWjSopLANB","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 liquidation data, open interest, taker flow, long/short ratios, funding rates, and a crowd-positioning verdict for a given crypto perpetual (e.g. BTC, ETH, SOL), paid per-call with USDC on Base via x402.","exampleAgentPrompt":"What does the current liquidation and positioning data look like for BTC perps — are longs or shorts getting wrecked, what's the open interest trend, and is there a crowding signal I should know about?","exampleUseCases":[{"title":"Pre-trade crowd positioning check","prompt":"Before I open a long on ETH perps, can you pull the latest liquidation data and long/short ratio to see if the market is overcrowded long and whether I'd be chasing a crowded trade?"},{"title":"Deleveraging alert for trading bot","prompt":"Check the BTC liquidation signal right now — specifically whether there's been a big spike in long liquidations and a meaningful drop in open interest in the last 4 hours that might indicate forced deleveraging."},{"title":"Funding rate arbitrage scan","prompt":"What are the current funding rates on Hyperliquid and OKX for SOL perps, and what does the taker flow look like? I want to see if there's a funding rate extreme worth fading."}],"resultDescription":"A JSON object containing: coin symbol; liquidation counts and USD volumes for longs and shorts over 1h, 4h, and 24h windows with dominant side; open interest in USD (OKX, Hyperliquid, total) with 1h/4h/24h % changes; taker buy/sell USD flows and ratio (1h); long/short ratio with 48h min/max/percentile and 24h change; funding rates (OKX 8h % and APR, Hyperliquid APR); a crowding score; a BALANCED/CROWDED_LONG/CROWDED_SHORT verdict; a human-readable action recommendation string; list of reasons supporting the verdict; timestamp; and suggested next API endpoints to call.","failureModes":["Invalid or unsupported coin symbol returns an error or empty data","Payment failure or insufficient USDC balance blocks the request under x402 protocol","Stale data if upstream Coinglass feed is delayed (check updated_at field)","Rate limiting or worker timeout under high load","Missing query param defaults to BTC — may confuse agents expecting explicit coin handling"],"whenToPreferThis":"Choose this endpoint when an AI trading agent needs a real-time, multi-dimensional positioning and liquidation snapshot for a crypto perpetual — specifically when you want liquidation dominance, open interest momentum, taker flow, funding rates, and a crowd-positioning verdict in a single call. Prefer over raw exchange APIs when you need cross-venue aggregation (OKX + Hyperliquid) without managing API keys, and when micropayment-per-call billing via x402/USDC on Base fits your agent's payment model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:10.701Z","isFirstParty":false,"canonicalSlug":"crypto-liquidations-positioning-signal-coinglass-via-x402-9767ede6"}