{"uid":"cap_q5uxw0aS3J9HbzP4z6AlC","slug":"crypto-long-short-sentiment-crowding-signal-765ce3e1","name":"Crypto Long/Short Sentiment & 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/nofx/long-short/list?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_4lf1Z_8mfLRxkv4spGlQL","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 perp market long/short ratio, open interest, liquidation data, funding rates, and a plain-English crowding verdict for a given coin","exampleAgentPrompt":"Is BTC perp positioning too crowded right now? Give me the long/short ratio, recent liquidations, and whether I should fade or follow the current positioning.","exampleUseCases":[{"title":"Pre-trade crowding check for BTC","prompt":"Before I open a BTC long, tell me if the market is already over-crowded with longs — show me the long/short ratio, crowding score, and what the verdict is."},{"title":"ETH liquidation cascade risk assessment","prompt":"Are there signs of a long squeeze building in ETH perps? I want to see recent liquidations, open interest changes over the last 4 hours, and the taker flow buy/sell ratio."},{"title":"SOL funding and positioning sentiment","prompt":"What's the current market sentiment for SOL perpetuals — give me the long/short ratio, funding rates on OKX and Hyperliquid, and whether positioning is a reason to fade or follow the trend."}],"resultDescription":"A JSON object containing: plain-English action recommendation and verdict (BALANCED, CROWDED_LONGS, CROWDED_SHORTS, etc.), crowding score, long/short ratio with 48h percentile and 24h change, open interest in USD across OKX and Hyperliquid with 1h/4h/24h changes, liquidation counts and dominant side for 1h/4h/24h windows, taker buy/sell flow ratios, funding rates (OKX 8h and APR, Hyperliquid APR), human-readable reasons list, and suggested next API calls.","failureModes":["Missing or invalid coin symbol returns an error or defaults to BTC","Payment not received via x402 returns HTTP 402 with payment instructions","Data freshness lag if upstream OKX or Hyperliquid feeds are delayed","Unsupported coin symbols (not listed on OKX perps) may return empty or error","Rate limiting if x402 payment flow is not properly implemented"],"whenToPreferThis":"Use this endpoint when you need a synthesized, opinionated signal about perpetual futures market crowding and positioning — not just raw data. It aggregates OKX and Hyperliquid long/short ratios, open interest, liquidations, and taker flow into a single verdict and recommendation, saving multiple separate API calls. Prefer it over building your own signal pipeline when you need a fast, pay-per-call answer about whether current positioning is a contrarian fade opportunity or momentum confirmation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:41.052Z","isFirstParty":false,"canonicalSlug":"crypto-long-short-sentiment-crowding-signal-765ce3e1"}