{"uid":"cap_PcX-WH4xgHSn6d9k-KD1q","slug":"crypto-long-short-ratio-crowding-signal-coinank-83342c43","name":"Crypto Long/Short Ratio & Crowding Signal (CoinAnk)","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/longshort/kline?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_hwIgDcZGIknurPZvCyeFF","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 long/short positioning, open interest, liquidations, taker flow, funding rates, and a plain-language crowding verdict for a given perp coin.","exampleAgentPrompt":"Before I open a BTC long on Hyperliquid, pull the current long/short ratio, open interest change, liquidation breakdown, and crowding verdict for BTC — I want to know if the market is already overcrowded.","exampleUseCases":[{"title":"Pre-trade crowding check for BTC perp","prompt":"Check the current long/short crowding signal for BTC — tell me the verdict, whether longs are getting liquidated, and whether I should fade or follow the crowd right now."},{"title":"ETH funding rate and positioning scan","prompt":"What's the current funding rate for ETH on OKX and Hyperliquid, and how is the long/short ratio trending over the last 24 hours? I want to know if ETH perps are expensive to hold long."},{"title":"SOL liquidation and taker flow review","prompt":"Pull the SOL liquidation data for the last 4 hours and show me the taker buy/sell ratio — I'm trying to figure out if there's been a forced deleveraging event."}],"resultDescription":"Returns a JSON object with: coin symbol, crowding_score (0–100), long_short_ratio (current, 24h ago, 48h percentile range), open_interest (OKX USD, Hyperliquid USD, total, % changes over 1h/4h/24h), liquidations (count, dominant side, long/short USD amounts for 1h/4h/24h), taker_flow (buy/sell USD and ratio for 1h), funding rates (OKX 8h%, OKX APR%, Hyperliquid APR%), verdict (BALANCED/CROWDED_LONGS/CROWDED_SHORTS/etc.), action (plain-language recommendation), reasons (bullet-style list explaining the signal), updated_at timestamp, and next-step endpoint suggestions.","failureModes":["Invalid coin symbol returns an error or empty response","Payment failure via x402 (insufficient USDC balance) blocks the call","Rate limiting if the x402 micropayment is not processed correctly","Stale data if upstream CoinAnk feed is delayed (check updated_at field)","Unknown or delisted coin may return null fields"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a single aggregated positioning signal before entering or sizing a perp trade — it combines long/short ratio, OI, liquidations, taker flow, and funding into one opinionated verdict. Prefer this over raw exchange APIs when you want an interpreted crowding score and plain-language action recommendation without building your own aggregation logic. Best for BTC, ETH, and major altcoin perps traded on OKX and Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:22.838Z","isFirstParty":false,"canonicalSlug":"crypto-long-short-ratio-crowding-signal-coinank-83342c43"}