{"uid":"cap_zHfJ5aHoHgg9NKWKbaJt5","slug":"api-usenami-io-84440de9","name":"Nami OI History — Perpetual Open Interest Timeseries","description":"Historical open-interest timeseries for one crypto perpetual on one venue, aggregated 1h/4h/1d — positioning over time for backtests and regime studies. 30–90d window cap.","url":"https://api.usenami.io/v1/perp/oi-history","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"},"method":{"type":"string"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XP0ePUDyd2nMdomO9YcLo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 timeseries data (1h/4h/1d resolution) for a given perpetual futures ticker and venue, covering up to a 30–90 day window.","exampleAgentPrompt":"Show me the 4-hour open interest history for BTC-PERP on Binance over the last 30 days — I want to see how OI has trended to spot accumulation or distribution signals.","exampleUseCases":null,"resultDescription":"A timeseries array of open interest values at the requested resolution (1h, 4h, or 1d) for the specified ticker and venue, including timestamps, raw OI figures, mark price at each point, and a units note explaining the denomination used by that venue. Window is capped at 30–90 days depending on resolution.","failureModes":["Invalid ticker or venue returns 404 or empty dataset","Requested window exceeds the 30–90d cap, returning truncated data or error","Unsupported resolution value returns validation error","Venue does not report open interest, resulting in empty or null response","Rate limiting or payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need historical OI trend data — e.g., to detect accumulation/distribution phases, validate breakout setups, or build time-series charts of positioning. Prefer this over the OI delta endpoint when you need the full timeseries rather than a single point-in-time change, and over the raw OI snapshot when temporal context is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:59.807Z","isFirstParty":false}