{"uid":"cap_-yFKDJKvB_zkRCjULlptu","slug":"hyperliquid-historical-open-interest-12afe6fe","name":"Hyperliquid Historical Open Interest","description":"First-party Hyperliquid trading intelligence: perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and HIP-4 prediction markets - computed from our own node_fills ledger plus the Hyperliquid public info API (no third-party data source). Free discovery (/healthz, /v1/stats, /.well-known/x402, /v1/openapi.json) and free sample routes (/v1/markets/overview, /v1/assets); all other API calls are $0.001 USDC per request via x402 on Base (no account, no API key).","url":"https://hyperliquid-data.v1337.org/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_BwqqEPhjaBvzSmf87yUmf","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":"Returns historical open interest data for Hyperliquid perpetual markets, computed from first-party node fills ledger.","exampleAgentPrompt":"Pull the historical open interest for BTC-PERP on Hyperliquid over the past 30 days so I can see how OI built up before the last big liquidation event.","exampleUseCases":[{"title":"Pre-liquidation OI spike analysis","prompt":"Show me the historical open interest for ETH-PERP on Hyperliquid for the past two weeks — I want to see if OI was unusually high before the recent price dump."},{"title":"Altcoin OI trend research","prompt":"Get me the open interest history for SOL-PERP on Hyperliquid going back 30 days so I can see whether traders have been accumulating long or short positions recently."},{"title":"Market structure backtesting","prompt":"I need historical open interest data for ARB-PERP on Hyperliquid for the entire month of March 2024 to backtest a strategy that trades on OI momentum signals."}],"resultDescription":"Returns a time-series array of open interest values for the requested Hyperliquid perpetual market, including timestamps and OI amounts (likely in USD or contract units), computed from Hyperliquid's own node fills ledger without third-party data sources.","failureModes":["Invalid or unsupported asset symbol returns an error or empty dataset","Time range too large may result in truncated or paginated response","Missing required body fields (asset, time range) causes a 400-level error","Payment not received or x402 flow incomplete results in 402 Payment Required","Hyperliquid node data lag may cause incomplete data for very recent timestamps"],"whenToPreferThis":"Choose this endpoint when you need first-party, node-verified historical open interest data specifically from Hyperliquid perpetual markets. It is preferable over aggregators or third-party data providers because it is computed directly from Hyperliquid's own fills ledger, ensuring accuracy. Use it when building trading analytics, backtesting OI-based strategies, or monitoring market structure changes on Hyperliquid perps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:32:24.889Z","isFirstParty":false}