{"uid":"cap_nd1bnuU9shKDWfbZ8Usup","slug":"crypto-derivatives-microdata-perpetuals-sentiment-positioning-3ef33ac8","name":"Crypto Derivatives Microdata — Perpetuals Sentiment & Positioning","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/v1/derivatives?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__xlg6u9WZSVZPTWV2jFzQ","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 real-time perpetuals derivatives data for a given coin: funding rates, open interest, liquidations, taker flow, long/short ratios, and a crowding verdict with action signal.","exampleAgentPrompt":"What's the current derivatives positioning signal for BTC — show me funding rates from OKX and Hyperliquid, open interest changes, liquidation breakdown for the last 4 hours, and whether the market is crowded or balanced.","exampleUseCases":[{"title":"Pre-trade crowding check for BTC","prompt":"Before I open a BTC long on Hyperliquid, check if the perp market is overcrowded — I want to see the long/short ratio, current funding rate, and whether the positioning verdict says I should fade or follow the crowd."},{"title":"ETH liquidation cascade monitoring","prompt":"Are there any significant liquidation cascades happening in ETH perps right now? Give me the 1h and 4h liquidation totals broken down by longs vs shorts, and tell me which side is dominant."},{"title":"SOL funding rate arbitrage research","prompt":"I'm looking at a funding rate arb between OKX and Hyperliquid for SOL — can you pull the current 8h and annualized funding rates for SOL perps on both venues so I can compare?"}],"resultDescription":"A JSON object containing: funding rates (OKX 8h %, OKX APR %, Hyperliquid APR %), open interest (OKX USD, Hyperliquid USD, total USD, 1h/4h/24h % change), liquidation data by timeframe (1h/4h/24h: count, dominant side, long/short USD liquidated), taker buy/sell flow (1h: buy USD, sell USD, ratio), long/short ratio (current %, 24h change, 48h min/max, percentile), crowding score (0-100), a human-readable positioning verdict (e.g. BALANCED), a plain-English action recommendation, an array of human-readable reasons, and suggested next endpoints to call.","failureModes":["Missing or invalid coin symbol returns an error or falls back to BTC default","Stale data if upstream OKX or Hyperliquid feeds are delayed — check updated_at timestamp","x402 payment failure if USDC balance on Base is insufficient","Worker cold-start latency may add 500ms+ on first call","Unsupported coin symbols (e.g. very low-cap tokens) may return empty or partial data"],"whenToPreferThis":"Choose this endpoint when your agent needs a comprehensive derivatives sentiment snapshot for a major crypto asset before placing or evaluating a perp trade. It uniquely combines funding rates from both OKX and Hyperliquid, liquidation flow, taker flow, open interest, and a ready-made positioning verdict in a single pay-per-call call with no API key required — ideal for autonomous trading agents operating on a USDC-on-Base budget via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:24.611Z","isFirstParty":false,"canonicalSlug":"crypto-derivatives-microdata-perpetuals-sentiment-positioning-3ef33ac8"}