Coin OI
FreeGET /oi/coin
OI timeseries for all exchanges reporting a given base coin, aggregated per venue. Returns a chronological series of daily snapshots showing how each exchange's OI on that coin has moved over the selected window. Use it to build per-coin OI charts, analyze cross-exchange divergences, or spot positioning shifts before price moves.
Authentication
Available on all tiers. Free tier: BTC and ETH only — requests for other coins return 403. Dev: all coins, 30-day max lookback. Pro: all coins, up to 90 days and beyond.
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
coin | string | – | Base symbol. Defaults to BTC. |
start_date | string (ISO 8601) | – | Start of range. Defaults to 7 days ago. |
end_date | string (ISO 8601) | – | End of range. Defaults to now. |
unit | string | – | usd (default) or coins. |
Tier behavior
- Free: BTC and ETH only. Requests for any other coin return 403 with required_tier: dev.
- Dev: All coins. Maximum 30-day lookback. Requests beyond this are clamped with a notice.
- Pro: All coins. Up to 90 days and beyond.
Example request
bash
curl -H "X-Api-Key: lk_live_your_key_here" \
"https://api.loris.tools/oi/coin?coin=ETH&start_date=2026-06-01"Example response
json
{
"data": [
{
"timestamp": "2026-06-01T00:00:00Z",
"exchange": "binance",
"open_interest_usd": 5800000000
},
{
"timestamp": "2026-06-01T00:00:00Z",
"exchange": "bybit",
"open_interest_usd": 2100000000
},
{
"timestamp": "2026-06-02T00:00:00Z",
"exchange": "binance",
"open_interest_usd": 5950000000
}
],
"notices": [],
"coin": "ETH",
"unit": "usd"
}Errors
403— Free tier requesting a coin other than BTC or ETH. Upgrade to Dev.
For authentication errors (401) and rate limit responses (429), see Errors.