{"uid":"cap_YmbsVoL4pC-oNVb-hIQIk","slug":"derivs-oi-decentralized-perpetuals-open-interest-feea1441","name":"derivs-oi: Decentralized Perpetuals Open Interest","description":"Open interest for a perpetual asset across decentralized venues (Hyperliquid, dYdX v4): per-venue open interest in coins and in USD notional (via each venue's mark or oracle price), the total aggregate USD open interest and each venue's share. One call, normalized across protocols.","url":"https://payai.agentstools.dev/derivs/oi","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Base asset ticker (BTC, ETH, SOL). A quote suffix such as BTC-USD or BTC-PERP is accepted and normalized server-side."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X2a0P0Am6IcMdEBW_LSd6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-venue and aggregate USD open interest for a perpetual asset across Hyperliquid and dYdX v4 in a single normalized call.","exampleAgentPrompt":"What's the current open interest for ETH across Hyperliquid and dYdX — give me per-venue breakdown in USD and the total aggregate?","exampleUseCases":[{"title":"Derivatives market sizing for a trading bot","prompt":"Pull the total USD open interest for BTC perpetuals across Hyperliquid and dYdX right now — I want to see each venue's share so my bot can decide where to route large orders."},{"title":"Risk dashboard for DeFi portfolio","prompt":"Show me the current open interest for SOL perps across decentralized venues with per-venue USD notional and aggregate total — I need this for my risk exposure dashboard."},{"title":"Market research on ETH perp liquidity","prompt":"How does ETH perpetual open interest compare between Hyperliquid and dYdX v4 today? Give me the coin amount and USD value for each venue and which one dominates."}],"resultDescription":"A JSON object containing per-venue open interest for the requested asset in both native coin units and USD notional (calculated via each venue's mark or oracle price), the total aggregate USD open interest summed across venues, and each venue's percentage share of that total.","failureModes":["Unsupported ticker symbol returns an error or empty result","Upstream venue API outage may cause stale or partial data","Network timeout if decentralized venue RPC is congested","Malformed symbol input not normalized correctly despite server-side handling"],"whenToPreferThis":"Choose this endpoint when you need a single normalized view of decentralized perpetuals open interest across Hyperliquid and dYdX v4 without having to query each protocol separately and reconcile their different data formats. It is ideal for agents building risk dashboards, order routing logic, or market analysis that depends on DeFi derivatives positioning data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:37.511Z","isFirstParty":false}