Symbol OI Timeseries
Free
GET /oi/{symbol}/timeseries
OI timeseries for all exchanges reporting a given base symbol, aggregated per venue. Returns clean hourly buckets for windows up to 7 days, and daily buckets for longer windows. Use it to build per-symbol OI charts, analyze cross-exchange divergences, or spot positioning shifts before price moves. Legacy /oi/coin remains available until July 21, 2026.
Authentication
Available on all tiers. Free tier: BTC and ETH only — requests for other symbols return 403. Dev: all symbols, 30-day max lookback. Pro: all symbols, full available historical depth.
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | ✓ | Base symbol in the path, for example BTC or ETH. |
start | string (ISO 8601) | – | Start of range. Date-only strings are accepted. Defaults to 7 days ago. start_date is accepted as a legacy alias. |
end | string (ISO 8601) | – | End of range. Date-only strings are accepted. Defaults to now. end_date is accepted as a legacy alias. |
unit | string | – | usd (default) or coins. |
Tier behavior
- Free: BTC and ETH only. Requests for any other symbol return 403 with required_tier: dev.
- Dev: All symbols. Maximum 30-day lookback. Requests beyond this are clamped with a notice.
- Pro: All symbols. Full available historical depth.
Example request
bash
curl -H "X-Api-Key: lk_live_your_key_here" \
"https://api.loris.tools/oi/ETH/timeseries?start=2026-06-01&end=2026-06-15"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",
"resolution": "1d"
}Errors
403— Free tier requesting a symbol other than BTC or ETH. Upgrade to Dev.
For authentication errors (401) and rate limit responses (429), see Errors.