{"uid":"cap_7eHdtAhmkWfZepjwSkjP7","slug":"hyperliquid-oi-history-cd386ab9","name":"Hyperliquid OI History","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/live/oi-history","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_HeXHrDVm963cbx3O82TSF","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, computed from first-party node fills and the Hyperliquid public info API","exampleAgentPrompt":"Pull the open interest history for BTC-PERP on Hyperliquid over the past 7 days — I want to see how OI has been trending hour by hour.","exampleUseCases":null,"resultDescription":"Returns a time-series of open interest values for the requested Hyperliquid perpetual market, including timestamps and OI amounts, computed from first-party node data.","failureModes":["Unknown or unsupported coin/market symbol returns an error or empty result","Time range too large may be rejected or truncated","HTTP 402 returned when free quota is exceeded, requiring USDC micropayment via x402","Malformed request body returns a 400 or validation error","Hyperliquid upstream unavailability may cause stale or missing data"],"whenToPreferThis":"Use this endpoint when you need historical open interest data specifically for Hyperliquid perpetual markets, sourced directly from first-party node fills rather than third-party aggregators. Prefer this over generic crypto data APIs when Hyperliquid-native accuracy matters, or when you need OI data to correlate with liquidation events or position lifecycle analysis on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:12.428Z","isFirstParty":false}