{"uid":"cap_9IjnKi3YDE84cknE1I1Yk","slug":"crypto-positioning-crowding-signal-x402-933c84d8","name":"Crypto Positioning & Crowding Signal (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/crypto/positioning?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_wE7nT6cnlf9TRJintBNeH","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 positioning data for a given coin — open interest, long/short ratios, liquidations, taker flow, and a crowding verdict — paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Check the current perpetual futures positioning for ETH — I want to know if the market is overcrowded long, what the long/short ratio looks like, recent liquidations, and whether there's a fade or follow signal.","exampleUseCases":[{"title":"Pre-trade crowding check for BTC","prompt":"Before I open a BTC long, check the perp positioning — is the market overcrowded with longs right now, and what's the crowding verdict and taker flow saying?"},{"title":"Deleveraging alert for ETH futures","prompt":"Has there been significant deleveraging in ETH perpetuals in the last 4 hours? Show me open interest change, liquidations, and the crowding score."},{"title":"Multi-coin positioning comparison","prompt":"Compare the positioning crowding signal for SOL — give me the long/short ratio, funding rate from both OKX and Hyperliquid, and tell me if I should be fading or following the crowd."}],"resultDescription":"A JSON object with: the coin ticker, a crowding_score (0–100), a human-readable verdict (e.g. BALANCED, CROWDED_LONG), an action string recommending fade/follow/neutral, a list of reason strings explaining the signal, open interest in USD and % changes over 1h/4h/24h, long/short ratio with 48h min/max and percentile, liquidation counts and USD amounts for longs vs shorts across 1h/4h/24h windows, taker buy/sell flow ratios, funding rates (OKX 8h%, OKX APR%, Hyperliquid APR%), and suggested next endpoints to call.","failureModes":["Invalid coin symbol returns error or defaults to BTC","x402 payment failure (insufficient USDC balance or wrong chain) blocks the response","Stale data if upstream OKX or Hyperliquid feeds are delayed","No data for obscure coins not listed on Hyperliquid perps","Rate limiting if payment infrastructure is congested"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs a fast, cheap, on-demand signal about perpetual futures crowding, open interest trends, or liquidation pressure for a specific coin — without maintaining API keys or subscriptions. Especially useful when building autonomous agents that self-pay per query via x402 USDC micropayments. Prefer over full data providers when you only need positioning/crowding intelligence rather than full OHLCV candles or order book depth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:18.806Z","isFirstParty":false,"canonicalSlug":"crypto-positioning-crowding-signal-x402-933c84d8"}