{"uid":"cap_AvAK7EBN7LhrS4eCkG9f7","slug":"hyperliquid-historical-open-interest-e89afeb2","name":"Hyperliquid Historical Open Interest","description":"Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).","url":"https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/markets/historical-oi","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"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_AZ1ttOos705FIYRFmuowT","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":"Retrieves historical open interest data for Hyperliquid perpetual markets over time","exampleAgentPrompt":"Show me the historical open interest for the BTC perpetual market on Hyperliquid over the past 30 days — I want to see how positioning has changed.","exampleUseCases":null,"resultDescription":"Returns a time-series dataset of open interest values for the specified Hyperliquid perpetual market, computed from first-party node fills ledger data, including timestamps and OI amounts in notional or contract units.","failureModes":["Invalid or unsupported coin/market symbol returns an error","Time range out of bounds or too far back may return empty or partial data","HTTP 402 returned when free quota is exhausted, requiring x402 USDC micropayment","Malformed POST body causes 400 bad request","Market not yet listed on Hyperliquid returns no data"],"whenToPreferThis":"Use this endpoint when you need first-party, operator-neutral historical open interest data specifically from Hyperliquid perpetual markets, sourced directly from a node fills ledger rather than third-party aggregators. Prefer this over generic crypto data APIs when accuracy and recency of Hyperliquid-specific OI are critical for trading research, risk analysis, or market structure studies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:24.024Z","isFirstParty":false}