TradePortfolio
DocsTop Symbols Timeseries
Docs

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 and Team: full stored history through custom start/end windows. Requests beyond your tier's limit are clamped.

Parameters

Query parameters

NameTypeRequiredDescription
exchangestring✓Lowercase exchange slug, e.g. binance.
limitinteger–Number of top symbols to include. Defaults to 50.
rangestring–7d, 30d, or 90d. Defaults to 7d. Cannot be combined with start/end.
startstring–Custom window start. Must be provided with end. Dev is clamped to the rolling 30-day lookback.
endstring–Custom window end. Must be after start.

Tier behavior

  • Dev: 30-day maximum. Requests for 90d are clamped to 30d with a notice.
  • Pro/Team: Full stored historical lookback through custom start/end windows.

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, invalid start/end, or range combined with start/end.

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

Related