Binance Open-Interest Data: Event Time vs Retrieval Time
Binance gives live open interest with a time field and historical OI by period. The two answer different timing questions.
Short answer
The openInterest endpoint returns current OI with a time field; openInterestHist returns sumOpenInterest and sumOpenInterestValue per period with a timestamp, covering about the last month and omitting periods with no trades. Use the live time for snapshots and the period timestamp for history. Don't mix them in one series without labelling, and record retrieval time for live calls.
Which times the data carries
| Time | Present? | Meaning |
|---|---|---|
| openInterest time | Yes | Snapshot time |
| openInterestHist timestamp | Yes | Period time |
| Omitted periods | Not returned | Gaps |
| Retrieval time | No | Record it |
Test Binance Open-Interest Data on a perpetual chart; no account is needed to chart.
Launch ChartsPodWhat to record yourself
| Field to store | Why |
|---|---|
| source endpoint | Live or history |
| time / timestamp | Event time |
| retrieved_at | Freshness |
| unit | Contracts/coins or USD |
| period | History granularity |
Example
Illustrative: a chart plots 5-minute history and appends a live reading at 12:03:17; the last point looks like a sudden OI jump because it's a snapshot, not a period statistic.
Related: Binance Open-Interest Data: Null vs Zero - Handle Missing Fields Correctly, AI Crypto Open-Interest Analysis: How to Check Timestamps Before Trusting the Answer.
Don't mix them in one series without labelling, and record retrieval time for live calls.
See Binance Open-Interest Data on live data in the free ChartsPod terminal.
Open the ChartsPod terminalQuestions readers ask
What's the difference between live and historical OI?
A snapshot with a time vs period statistics.
Are there gaps?
History omits periods with no trades.
How far back?
About one month.
Sources and methodology
Field definitions come from DEX Screener's API reference and CoinGecko's onchain API documentation, read 17 October 2026. Where a schema doesn't document a timestamp, this guide says so and recommends recording retrieval time yourself.
- Binance: USD-M market data (long/short ratios, OI statistics, klines) — ratio definitions, 30-day retention, kline open/close time.
- Binance: USD-M Futures market data API — trades, depth, funding and open interest.
This article explains research tools and workflows. It is not financial advice, does not recommend buying or selling any asset and does not predict prices. Crypto derivatives carry a risk of rapid and total loss of margin.
CHARTSPOD EDITORIAL EDITION · RESEARCH AND EDUCATION ONLY · NOT FINANCIAL ADVICE.