{"uid":"cap_tYRJMz4I4oOFIgJGPSk8i","slug":"crypto-net-positions-crowding-signal-95766d32","name":"Crypto Net Positions & 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/coinank/net-positions?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_LOsPGyZP7aHYhwTB9QzgI","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 perpetual futures net positioning data including open interest, long/short ratios, liquidations, taker flow, and a crowding verdict for a given coin","exampleAgentPrompt":"Check the current net positioning and crowding verdict for BTC perps — I want to know if longs are overcrowded, what the recent liquidations look like, and whether taker flow is bullish or bearish.","exampleUseCases":[{"title":"Pre-trade crowding check for perp entry","prompt":"Before I open a long on ETH perps, can you check whether ETH is overcrowded on the long side and what the crowding score looks like right now?"},{"title":"Detect deleveraging signal on SOL","prompt":"Is there any sign of forced deleveraging on SOL futures? I want to see open interest changes, recent liquidations, and whether longs or shorts are getting squeezed."},{"title":"Funding rate and positioning sanity check","prompt":"Pull the funding rates and long/short ratio for BTC perps and tell me whether the positioning gives a reason to fade or follow the current trend."}],"resultDescription":"A JSON object containing: crowding verdict (BALANCED, LONG_CROWDED, SHORT_CROWDED, etc.), crowding score, action recommendation string, reasons array, open interest in USD across venues (OKX, Hyperliquid, total) with 1h/4h/24h % changes, long/short ratio with 48h percentile and 24h change, liquidation counts and USD volumes by 1h/4h/24h timeframe with dominant side, taker buy/sell flow with ratio, funding rates (OKX 8h%, OKX APR%, Hyperliquid APR%), and suggested next API calls.","failureModes":["Invalid or unrecognized coin symbol returns an error or empty data","Payment not processed via x402 results in HTTP 402 response requiring USDC payment on Base","Stale data if upstream CoinAnk feed is delayed — check updated_at timestamp","Very low-liquidity coins may have incomplete OI or liquidation data"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a rapid, single-call summary of perpetual futures positioning health for a coin — specifically crowding, liquidation dynamics, taker flow, and funding rates — without needing to aggregate multiple data sources. Prefer it over raw exchange APIs when you want a pre-interpreted verdict (BALANCED / LONG_CROWDED) and don't want to manage API keys. Best for pre-trade checks or periodic market regime monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:19.356Z","isFirstParty":false,"canonicalSlug":"crypto-net-positions-crowding-signal-95766d32"}