{"uid":"cap__S337FTpGffd8YclUeyGO","slug":"bykaranteli-open-interest-5m-history-9386f3f0","name":"ByKaranteli Open Interest 5m History","description":"Five minute open interest history for the major perpetuals in base units and USD, normalised across symbols and retained on our side, so one query replaces per-symbol paginated pulls against exchange endpoints.","url":"https://bykaranteli.com/api/x402/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","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"iso, optional"},"from":{"type":"string","description":"iso, optional"},"limit":{"type":"number","description":"number, optional, max 20000"},"symbol":{"type":"string","description":"string, optional"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"rows":[],"count":500,"dataset":"oi-history"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.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_OOd287VWiJ07f7NZjyFmn","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 five-minute interval open interest history for major perpetual contracts in both base units and USD, normalised across symbols and exchanges.","exampleAgentPrompt":"Pull the 5-minute open interest history for BTCUSDT on Binance from January 10 to January 15 2025, denominated in USD, up to 500 rows.","exampleUseCases":[{"title":"Quant model OI feature backfill","prompt":"I need the 5-minute open interest history for ETHUSDT on Bybit from March 1 to March 31 2025 in USD — give me up to 500 rows so I can build an OI feature for my momentum model."},{"title":"Pre-liquidation OI spike detection","prompt":"Can you pull the 5-minute open interest data for SOLUSDT across all exchanges for the 24 hours ending January 20 2025 at midnight? I want to see if there was an unusual OI spike before the price drop."},{"title":"Cross-symbol OI trend comparison","prompt":"Get me the 5-minute open interest history in base units for BTCUSDT, limit to 200 rows ending today, so I can compare it against the funding rate series I already have."}],"resultDescription":"A JSON object with an `ok` boolean, a `dataset` label (`oi-history`), a `count` of returned rows, and a `rows` array — each row containing timestamped open interest values in both base units and USD for the requested symbol and exchange, normalised to a consistent schema across venues.","failureModes":["Invalid or unsupported symbol returns empty rows or an error message","Date range too wide may be silently capped by the per-dataset row limit","Missing required query parameters may return an empty result set","Unsupported exchange filter returns no data without an explicit error","Payment failure (x402) results in a 402 response before any data is returned","Very recent windows may have incomplete data if ingestion lag exists"],"whenToPreferThis":"Choose this endpoint when you need pre-aggregated, exchange-normalised 5-minute open interest history for perpetuals without having to paginate individual exchange APIs. It is especially valuable for quant workflows, backtesting, and feature engineering where consistent cross-venue OI time series are needed in a single call. Prefer it over raw exchange endpoints when you want both base-unit and USD-denominated OI already joined and retained server-side.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:55.322Z","isFirstParty":false}