Type: OPEN_INTEREST_AGG | Weight: 1x | Max points: 100,000
Open interest expressed as OHLC candles. Each value represents the total open interest at that point in the interval.
Response fields
| Field | Type | Description |
|---|
open | double (optional) | Open interest at interval start |
high | double (optional) | Peak open interest in the interval |
low | double (optional) | Lowest open interest in the interval |
close | double (optional) | Open interest at interval end |
timestamp | Timestamp | Start of the interval |
Fields are optional — some exchanges may not report all OHLC values for every interval.
Capabilities
| Feature | Supported | Details |
|---|
| USD denomination | Yes | transform.normalize.quote=USD converts OI to USD |
| Multi-exchange aggregation | Yes | transform.groupBy.type=GROUP_BY_TYPE_SUM with coin param |
| Gapfill | No | Supported only for TRADE_SIDE_AGNOSTIC_AGG and TRADE_AGG |
Examples
Single exchange (coin values)
Fetches 1 hour of hourly open interest for BTCUSDT on Binance Futures. Values are returned in coin terms (BTC).
curl "https://api.kiyotaka.ai/v1/points?type=OPEN_INTEREST_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600" \
-H "X-Kiyotaka-Key: YOUR_API_KEY"
Aggregated across exchanges (USD)
Sums open interest across Binance Futures, Bybit, and OKX for all BTC pairs into a single series. Values are converted to USD for cross-exchange comparability.
curl "https://api.kiyotaka.ai/v1/points?type=OPEN_INTEREST_AGG&exchange=BINANCE_FUTURES&exchange=BYBIT&exchange=OKEX_SWAP&coin=BTC&interval=HOUR&from=1774800000&period=3600&transform.groupBy.type=GROUP_BY_TYPE_SUM&transform.normalize.quote=USD" \
-H "X-Kiyotaka-Key: YOUR_API_KEY"
Response
{
"series": [
{
"id": {
"type": "OPEN_INTEREST_AGG",
"exchange": "BINANCE_FUTURES",
"rawSymbol": "BTCUSDT",
"normalizedSymbol": "BTC-USDT",
"category": "PERPETUAL",
"interval": "HOUR",
"coin": "BTC"
},
"points": [
{
"Point": {
"open": 95444.539,
"high": 95612.984,
"low": 95443.774,
"close": 95539.108,
"timestamp": { "s": 1774800000 }
}
}
]
}
]
}
