{"uid":"cap_eToeoXEMY4-3CWoN23yYH","slug":"agent402-perpetuals-open-interest-6fca4199","name":"Agent402 Perpetuals Open Interest","description":"Open interest for one perpetual in coins and USD notional with its share of the venue total, or the top N contracts ranked by open interest plus the venue total. Use it when an agent needs positioning size for a market or a leaderboard of where leverage is concentrated right now.","url":"https://agent402.tools/api/perp-open-interest","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"coin":{"type":"string","description":"Optional perp ticker for a single market (e.g. BTC)."},"limit":{"type":"number","description":"Rows when ranking (default 20, max 500)."}}},"responseSchema":{"type":"json","example":{"source":"hyperliquid","markets":[{"coin":"BTC","markPx":77267,"openInterest":35935.67,"volume24hUsd":4679441788.67,"openInterestUsd":2776803000,"shareOfTotalPct":29.2}],"fetchedAt":"2026-08-22T12:00:00.000Z","totalOpenInterestUsd":9500000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZFj8eFUUjQA1UDbR9M8NA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live perpetual futures open interest data across markets from Hyperliquid, optionally filtered to a single coin, ranked by size","exampleAgentPrompt":"Show me the top 10 perpetual futures markets ranked by open interest right now — I want to see the mark price, open interest in USD, and each market's share of total OI.","exampleUseCases":[{"title":"BTC perp OI snapshot for trading decision","prompt":"What's the current open interest for BTC perps on Hyperliquid? Give me the mark price, OI in USD, and 24h volume."},{"title":"Top perp markets leaderboard","prompt":"Rank the top 25 perpetual futures markets by open interest and show me each one's share of the total — I want to see where the biggest bets are concentrated."},{"title":"Monitor ETH perp market size","prompt":"Pull the latest open interest and 24h volume for ETH perpetual futures so I can track how market positioning has changed."}],"resultDescription":"A JSON object with the data source ('hyperliquid'), a timestamp, total open interest in USD across all markets, and an array of market objects each containing the coin ticker, mark price, open interest in contracts and USD, 24h volume in USD, and that market's percentage share of total open interest. Results are ranked by open interest when no specific coin is requested.","failureModes":["Invalid coin ticker returns empty markets array or 404-equivalent error","limit exceeding 500 returns validation error","Hyperliquid data feed temporarily unavailable returns upstream error","Malformed request body returns 400 with schema validation message"],"whenToPreferThis":"Choose this endpoint when you need real-time perpetual futures open interest data sourced from Hyperliquid, especially for ranking markets by size or checking a specific coin's OI. Prefer this over CEX-based alternatives when you need on-chain/DeFi perp data without API key setup, and when you want normalized USD-denominated OI with volume and market-share metrics in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:56:06.796Z","isFirstParty":false}