{"uid":"cap_0BGN4uLCeFzdWeT83-fiF","slug":"hyperliquid-open-interest-top-ranking-10976c3a","name":"Hyperliquid Open Interest Top Ranking","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/oi/top-ranking?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":{"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Rows per ranking (default 10)"},"min_volume_usd":{"type":"number","minimum":0,"description":"Liquidity filter on 24h notional volume (default 1000000)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"venue":"hyperliquid","liquid":140,"breadth":{"label":"broad_rally","advancers":96,"decliners":44,"advance_ratio":0.686},"sources":["https://api.hyperliquid.xyz/info"],"universe":230,"top_losers":[],"top_volume":[],"updated_at":"2026-10-29T16:00:00Z","top_gainers":[{"coin":"HYPE","mark_px":41.2,"premium_bps":-1.1,"max_leverage":10,"vol_oi_ratio":0.34,"change_24h_pct":8.4,"volume_24h_usd":410000000,"funding_apr_pct":14.2,"open_interest_usd":1200000000}],"highest_funding":[],"unusual_activity":[],"top_open_interest":[],"most_negative_funding":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_26rzyRw-ttSaD-RvEHinh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked snapshot of Hyperliquid perpetuals by open interest, volume, funding, and market breadth — paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"Show me the top 15 Hyperliquid perpetuals ranked by open interest, filtering for coins with at least $5M in 24h volume — include gainers, funding rates, and the overall market breadth.","exampleUseCases":[{"title":"Momentum screening before a trade","prompt":"Which Hyperliquid perps are in the top 10 by open interest right now, have positive 24h performance, and high funding — I want to find crowded longs before I fade them? Filter for at least $2M daily volume."},{"title":"Daily market breadth report","prompt":"Give me a summary of today's Hyperliquid perp market — how many coins are advancing vs declining, what's the breadth label, and who are the top gainers and losers? Use the default limit of 10."},{"title":"Funding rate arbitrage scan","prompt":"Pull the Hyperliquid open interest rankings and show me the coins with the highest and most negative funding rates — I'm looking for funding arbitrage setups. Filter out anything with less than $1M in daily volume."}],"resultDescription":"A JSON object with venue metadata, universe and liquid coin counts, advance/decline breadth (label, advancer/decliner counts, advance ratio), and ranked arrays for top gainers, top losers, top volume, top open interest, highest funding, most negative funding, and unusual activity — each entry including coin name, mark price, 24h change %, 24h volume USD, open interest USD, funding APR %, vol/OI ratio, max leverage, and premium bps.","failureModes":["Payment not included or malformed x402 USDC payment header — returns 402 Payment Required","limit parameter outside 1–25 range — returns 400 validation error","min_volume_usd below 0 — returns 400 validation error","Hyperliquid upstream API unavailable — may return 502 or stale data","No coins pass the min_volume_usd filter — ranked arrays return empty"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a single ranked snapshot of the entire Hyperliquid perpetuals market — covering open interest, funding, volume, gainers/losers, and breadth — without managing API keys. It is ideal for momentum screening, funding arbitrage detection, or daily market summaries. Prefer it over raw Hyperliquid API calls when micropayment simplicity (x402, no key management) matters, and over generic crypto data APIs when Hyperliquid-specific funding and OI ranking is the core need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:10.371Z","isFirstParty":false,"canonicalSlug":"hyperliquid-open-interest-top-ranking-10976c3a"}