{"uid":"cap_SGjE7_nkTjtJdi8Y1rwok","slug":"perpetual-open-interest-aggregator-hyperliquid-dydx-v4-8a187d75","name":"Perpetual Open Interest Aggregator (Hyperliquid + dYdX v4)","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://api.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_ltJV-Z1Uv-MjJhnHN3EeY","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 normalized open interest for a perpetual asset across Hyperliquid and dYdX v4, including per-venue coin amounts, USD notional, total aggregate USD OI, and each venue's share.","exampleAgentPrompt":"What's the current total open interest for BTC perpetuals across Hyperliquid and dYdX v4, and how is it split between the two venues?","exampleUseCases":null,"resultDescription":"A JSON object containing per-venue open interest for each decentralized exchange (in native coin units and USD notional using mark/oracle price), the total aggregate USD open interest across all venues, and each venue's percentage share of total OI.","failureModes":["Unknown or unsupported ticker symbol returns a 4xx error or empty result","Venue API downtime may cause partial results or degraded response","Malformed symbol input (e.g. unsupported format) is normalized server-side but extreme edge cases may fail","Rate limiting or payment failure (x402) returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a single normalized view of perpetual open interest across both Hyperliquid and dYdX v4 simultaneously, rather than querying each venue's API separately and reconciling units and pricing yourself. Ideal for market structure analysis, venue dominance tracking, and cross-protocol OI comparison with a single cheap call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:34.121Z","isFirstParty":false}