GET /v1/open-interest
Returns current open interest data for perpetual futures contracts.
Query Parameters
Filter by symbol (e.g., BTC, ETH). Omit for all symbols.
All Symbols Response
curl "https://api.crypton.dev/v1/open-interest"
{
"status": "ok",
"timestamp": 1709640000000,
"data": {
"BTC": {
"total_oi_usd": 15234567890.50,
"exchange_count": 12
},
"ETH": {
"total_oi_usd": 8123456789.25,
"exchange_count": 11
}
}
}
Response Fields
Map of symbol → aggregated OI data.
Total open interest in USD across all reporting exchanges. Uses f64 — handles values up to $10T+ without overflow.
Number of exchanges reporting OI for this symbol.
Single Symbol Response
curl "https://api.crypton.dev/v1/open-interest?symbol=BTC"
{
"status": "ok",
"timestamp": 1709640000000,
"data": {
"symbol": "BTC",
"total_oi_usd": 15234567890.50,
"exchanges": {
"binance": {
"oi_usd": 5200000000.00,
"oi_contracts": 73239.5,
"updated_at": 1709639900000
},
"bybit": {
"oi_usd": 3100000000.00,
"updated_at": 1709639850000
}
}
}
}
Per-Exchange Fields
Open interest in USD for this exchange.
Open interest in base asset contracts (e.g., BTC). Not all exchanges provide this.
Unix timestamp (ms) of last update.
Signal Analysis
| OI Change | + Price | Meaning |
|---|
| ↑ Rising | ↑ Rising | New longs entering — trend continuation |
| ↑ Rising | ↓ Falling | New shorts entering — bearish pressure |
| ↓ Falling | ↑ Rising | Short covering rally — may exhaust |
| ↓ Falling | ↓ Falling | Long liquidation cascade — capitulation |
Rising OI + extreme funding is a crowding signal — new positions entering against the wind. This is the highest-conviction setup for mean-reversion.
Field Reference
| Field | Type | Description | Granularity | Example |
|---|
total_oi_usd | number | Aggregate open interest in USD across all exchanges (f64) | ~30s aggregated | 15234567890.50 |
exchange_count | integer | Number of exchanges reporting OI for this symbol | ~30s | 12 |
oi_usd | number | Per-exchange open interest in USD | ~30s per exchange | 5200000000.00 |
oi_contracts | number | null | OI in base asset units. Not all exchanges provide this | ~30s per exchange | 73239.5 |
updated_at | integer | Unix ms of last fetch from exchange | ~30s | 1709639900000 |
Data Sources
OI data from 17+ sources: CEX — Binance, Binance COIN-M, Bybit, OKX, Bitget, Gate.io, MEXC, HTX, KuCoin Futures, Coinbase, Backpack, Deribit, BitMEX, Hyperliquid, dYdX. DeFi Perps — Drift (Solana, 63+ markets), Avantis (Base, 96 pairs), Jupiter Perps (Solana, 3 markets). All values converted to USD using oracle/mark prices. Sources polled every ~30s with concurrent fetches.
Live Testing
# All symbols OI summary
curl -s "https://api.crypton.dev/v1/open-interest" | jq 'to_entries[:5]'
# BTC with per-exchange breakdown
curl -s "https://api.crypton.dev/v1/open-interest?symbol=BTC" | jq .
