{"uid":"cap_2NWYCvAY8xqvOUrblnCFa","slug":"hyperliquid-perps-open-interest-lookup-0fc58aa4","name":"Hyperliquid Perps Open Interest Lookup","description":"Open interest for a coin (with USD notional) or the top perps by open interest across Hyperliquid. Send { coin } or { limit }. Positioning & liquidity depth for derivatives agents.","url":"https://x402-services-production.up.railway.app/api/perps/oi","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"coin":{"type":"string","description":"Perp symbol; omit to list top markets by OI"},"limit":{"type":"number","description":"Max markets when listing, default 15 (max 50)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-f4fwWETX63xpBBeyGDKj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns open interest (with USD notional) for a specific perpetuals coin on Hyperliquid, or lists the top perp markets ranked by open interest.","exampleAgentPrompt":"What's the current open interest for BTC perps on Hyperliquid, including the USD notional value? Also show me the top 15 markets ranked by OI.","exampleUseCases":[{"title":"Compare ETH and SOL perp positioning","prompt":"Can you pull the open interest for both ETH and SOL perpetuals on Hyperliquid? I want to compare their USD notional values to see where traders are positioning more heavily."},{"title":"Find most liquid perp markets","prompt":"Show me the top 20 perpetuals markets on Hyperliquid ranked by open interest — I'm trying to figure out which ones have the deepest liquidity before I size into a trade."},{"title":"Check ARB derivatives positioning depth","prompt":"What's the current open interest for ARB perps on Hyperliquid, and what's the USD notional? I want to understand how much positioning is sitting in that market right now."}],"resultDescription":"Returns open interest figures for the queried coin (including USD notional value), or a ranked list of up to 50 perp markets by open interest, with per-market OI and USD notional figures — useful for assessing positioning and liquidity depth in Hyperliquid derivatives markets.","failureModes":["Unknown or unsupported coin symbol returns an error or empty result","Limit exceeding 50 is clamped or rejected","Hyperliquid data feed unavailable causes service error","Malformed request body (wrong types) returns 400-level error"],"whenToPreferThis":"Use this endpoint when you need open interest data specifically from Hyperliquid perpetuals — either for a single coin's positioning depth or to rank top perp markets by OI. Prefer this over generic market data APIs when the user explicitly needs Hyperliquid-specific derivatives positioning or liquidity context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:56:43.072Z","isFirstParty":false}