{"uid":"cap_xbSmTBIZlDDrnxAVRw2Yk","slug":"hyperliquid-open-interest-history-6bbc98b3","name":"Hyperliquid Open Interest History","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/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_PArz-tqnya1ie2ej5WGC6","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 time-series open interest history for Hyperliquid perpetuals, computed from first-party node fills and the Hyperliquid public info API","exampleAgentPrompt":"Pull the open interest history for ETH-PERP on Hyperliquid over the past 7 days so I can see how positioning has been building up.","exampleUseCases":[{"title":"Pre-liquidation OI spike detection","prompt":"Show me the open interest history for BTC-PERP on Hyperliquid for the last 30 days — I want to see if there were any big OI spikes right before the major liquidation events this month."},{"title":"Asset comparison for OI trend analysis","prompt":"Get me the open interest history for SOL-PERP on Hyperliquid over the past two weeks so I can compare how positioning has evolved versus the price action."},{"title":"Market health monitoring for trading strategy","prompt":"I need the open interest time series for ARB-PERP on Hyperliquid from the last 24 hours — I'm trying to gauge whether the market is accumulating or unwinding positions before I enter a trade."}],"resultDescription":"Returns a time-series array of open interest data points for the specified Hyperliquid perpetual asset, including timestamps and OI values in USD or contract units, sourced directly from first-party node fills ledger and Hyperliquid public info API.","failureModes":["Invalid or unsupported asset symbol returns an error or empty dataset","Time range outside available ledger history returns partial or empty results","Malformed JSON body causes 400 bad request","Payment not fulfilled via x402 on Base results in 402 Payment Required","Rate limiting or node unavailability causes 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need first-party, on-chain open interest history for Hyperliquid perpetuals without relying on third-party data aggregators. Prefer this over generic crypto data APIs when you specifically need Hyperliquid-native OI data computed from node fills, and when paying per-call with no account signup is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:26.572Z","isFirstParty":false}