{"uid":"cap_uvFm7tgVooXC2VCKmPhyr","slug":"bykaranteli-options-oi-by-strike-history-348742e1","name":"ByKaranteli Options OI By Strike History","description":"Daily listed options open interest per instrument: strike, expiry, option type, open interest, mark implied volatility, underlying price and traded notional. History from 2026-08-06 (rolling window; rows before that date do not exist).","url":"https://bykaranteli.com/api/x402/options-oi-history?utm_source=zero.xyz","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","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"date, optional"},"from":{"type":"string","description":"date, optional"},"limit":{"type":"number","description":"number, optional, max 20000"},"venue":{"type":"string","description":"string, optional options venue: deribit | bybit | binance | okx | delta"},"currency":{"type":"string","description":"string, optional BTC or ETH"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"options-oi-history"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CYmJstBUBZWwllKwj5iWp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily listed options open interest history per instrument, broken down by strike, expiry, option type, implied volatility, underlying price, and traded notional.","exampleAgentPrompt":"Pull the daily options open interest history for BTC broken down by strike and expiry from January 1 to March 31 2025, up to 500 rows, so I can see where OI was concentrated and what the mark IV was at each level.","exampleUseCases":[{"title":"Options positioning analysis before expiry","prompt":"Show me the BTC options open interest by strike for the last 30 days — I want to see where OI is piling up near upcoming expiries and what the implied volatility looks like at each strike."},{"title":"ETH options IV surface reconstruction","prompt":"Fetch me the daily options OI history for ETH from March 1 to March 31 2025, including mark implied volatility and underlying price at each strike, so I can reconstruct the vol surface over that period."},{"title":"Cross-symbol options flow comparison","prompt":"Get me options open interest history for SOL from the start of this year through end of Q1, filtered by symbol, with traded notional and OI per strike so I can compare how positioning evolved across different expirations."}],"resultDescription":"Returns a JSON object with ok status, a dataset label ('options-oi-history'), a count of rows returned, and a rows array where each entry contains the instrument's strike price, expiry date, option type (call/put), open interest quantity, mark implied volatility, underlying spot price at time of snapshot, and traded notional — all at daily granularity.","failureModes":["No rows returned if symbol or date range has no data coverage","Limit parameter capped at dataset maximum regardless of requested value","Invalid or unsupported symbol returns empty rows or error","Missing required query parameters may return generic error or empty result","Rate limiting or payment failure returns 402 or access denied error"],"whenToPreferThis":"Choose this endpoint when you need granular, strike-level options open interest history with accompanying implied volatility and notional data for crypto assets. It is the right choice for vol surface analysis, max pain calculations, gamma exposure modeling, or studying how options positioning evolved over time at specific strikes and expiries. Prefer it over aggregate OI endpoints when strike-level detail matters, and over the IV index endpoint when you need per-strike breakdown rather than a single daily index value.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:38:46.749Z","isFirstParty":false,"canonicalSlug":"bykaranteli-options-oi-by-strike-history-348742e1"}