Top Symbols Timeseries

Dev

GET /oi/exchange-top-symbols-timeseries

Daily OI USD timeseries for the top N symbols on one exchange, returned in wide format where each row is a timestamp and each column is a symbol. Designed for stacked area charts that show how the composition of an exchange's OI shifts over time — which coins are growing, which are declining.

Authentication

Requires Dev tier or higher. Dev: 30-day max range. Pro: up to 90 days. Requests beyond your tier's limit are clamped.

Parameters

Query parameters

Name	Type	Required	Description
`exchange`	string	✓	Lowercase exchange slug, e.g. binance.
`limit`	integer	–	Number of top symbols to include. Defaults to 50.
`range`	string	–	7d, 30d, or 90d. Defaults to 7d.

Tier behavior

Dev: 30-day maximum. Requests for 90d are clamped to 30d with a notice.
Pro: Up to 90 days.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/oi/exchange-top-symbols-timeseries?exchange=binance&range=7d&limit=5"

Example response

json

{
  "timeseries": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "BTC": 7200000000,
      "ETH": 3100000000,
      "SOL": 980000000,
      "DOGE": 420000000,
      "XRP": 380000000
    },
    {
      "timestamp": "2026-06-02T00:00:00Z",
      "BTC": 7350000000,
      "ETH": 3080000000,
      "SOL": 1010000000,
      "DOGE": 415000000,
      "XRP": 392000000
    }
  ],
  "symbols": ["BTC", "ETH", "SOL", "DOGE", "XRP"]
}

Errors

400 — Missing required parameter exchange.

For authentication errors (401) and rate limit responses (429), see Errors.