{"uid":"cap_dCpjWyCow5Td18E6h0A6I","slug":"api-usenami-io-6a38e65d","name":"Nami OI Delta — Open Interest Change Signal","description":"Open-interest delta for one crypto perpetual on one venue — current OI against OI N hours ago. Accumulation or distribution signal: whether positioning is building or unwinding.","url":"https://api.usenami.io/v1/perp/oi-delta","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":{"request":{"type":"GET","hours":4,"venue":"binance","method":"perp/oi-delta","ticker":"BTC"},"response":{"venue":"binance","ticker":"BTC","past_oi":102686.147,"past_ts":"2026-06-17T01:00:00Z","delta_pct":-2.9906,"current_oi":99615.178,"current_ts":"2026-06-18T03:00:00Z","lookback_hours":24}},"exampleRequest":{"type":"GET","hours":4,"venue":"binance","method":"perp/oi-delta","ticker":"BTC"},"tags":["x402"],"displayCostAmount":"0.003000","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.003000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5e7pDfYGtBZEon46P6l75","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the change in open interest for a given ticker and venue between now and N hours ago, serving as an accumulation/distribution signal.","exampleAgentPrompt":"What's the open interest delta for BTC-USDT perps on Binance over the last 4 hours — is there net accumulation or distribution happening?","exampleUseCases":null,"resultDescription":"Returns the current open interest, the open interest N hours ago, and the delta between them for the specified ticker and venue, along with a directional signal indicating accumulation or distribution pressure.","failureModes":["Unknown ticker or venue returns a 404 or empty result","Lookback window too large or outside supported range returns an error","Venue data unavailable or delayed may return stale or null OI values","Payment not included or invalid x402 payment header results in 402 error","Malformed input schema returns 400 validation error"],"whenToPreferThis":"Use this endpoint when you need a quick directional signal on whether open interest is growing (accumulation) or shrinking (distribution) over a specific time window for a perpetual futures ticker, rather than needing a full historical timeseries. Prefer this over the historical OI timeseries endpoint when you only need the delta between now and a lookback point, not the full data series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:38.326Z","isFirstParty":false}