{"uid":"cap_BBFXb5q5r2-ojbBswywxL","slug":"coinglass-long-short-ratio-derivatives-sentiment-6d52a4ef","name":"Coinglass Long/Short Ratio & Derivatives Sentiment","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/long-short?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_Y4Q6ZhMlq7UCUKzGPhRFs","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 long/short ratio, open interest, liquidations, taker flow, and a crowding verdict for a given crypto perpetual contract coin","exampleAgentPrompt":"What's the current long/short ratio, liquidation breakdown, and crowding verdict for BTC perpetuals — and is this a good reason to fade or follow the crowd?","exampleUseCases":[{"title":"Pre-trade crowding check for BTC","prompt":"Before I go long BTC, tell me if perp traders are already heavily crowded long — show me the long/short ratio, open interest change over the last 4 hours, and whether the crowding score suggests I should fade or follow."},{"title":"Monitoring ETH liquidation cascades","prompt":"Check whether ETH perps are seeing a liquidation cascade right now — I want to know how many longs vs shorts have been liquidated in the last hour and 4 hours, and what the taker flow looks like."},{"title":"Funding rate comparison for SOL","prompt":"What's the current funding rate for SOL perpetuals on OKX and Hyperliquid, and is the long/short ratio sitting at an extreme high or low compared to the last 48 hours?"}],"resultDescription":"A JSON object containing: the coin's long/short ratio with 48h min/max percentile context, open interest in USD (OKX and Hyperliquid), OI change over 1h/4h/24h, liquidation counts and dominant side over 1h/4h/24h in USD, taker buy/sell ratio and volumes, funding rates (OKX 8h and annualized, Hyperliquid annualized), a crowding score (0-100), a BALANCED/CROWDED_LONG/CROWDED_SHORT verdict, an action recommendation string, human-readable reasons, and suggested next API calls.","failureModes":["Invalid or unsupported coin symbol returns error or empty result","Upstream Coinglass data unavailable causes stale or missing fields","Payment failure via x402 (insufficient USDC balance or Base network issue) blocks the call","Rate limiting or worker timeout on high-traffic periods"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a synthesized derivatives sentiment signal — combining long/short ratio, liquidations, open interest, and taker flow in a single call with a pre-computed crowding verdict. Prefer this over raw exchange APIs when you want actionable interpretation (BALANCED/CROWDED verdict + reasons) rather than raw numbers, and when paying micro-amounts per call without API key setup is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:25.633Z","isFirstParty":false,"canonicalSlug":"coinglass-long-short-ratio-derivatives-sentiment-6d52a4ef"}