TradePortfolio
DocsTop Symbols Timeseries
Docs

Top Symbols Timeseries

Dev

GET /volume/exchange-top-symbols-timeseries

Daily volume USD timeseries for the top N symbols on one exchange, in wide format where each row is a timestamp and each column is a symbol. Designed for stacked area charts that visualize how the volume composition of an exchange shifts over time — useful for spotting rotation between majors and altcoins, or long-term trend analysis.

Authentication

Requires Dev tier or higher. Dev: 30-day max range. Pro and Team: full stored history through custom start/end windows.

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/volume/exchange-top-symbols-timeseries?exchange=binance&range=7d&limit=5"

Example response

json
{
  "timeseries": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "BTC": 11200000000,
      "ETH": 4800000000,
      "SOL": 2100000000,
      "DOGE": 980000000,
      "XRP": 720000000
    },
    {
      "timestamp": "2026-06-02T00:00:00Z",
      "BTC": 12000000000,
      "ETH": 5100000000,
      "SOL": 2400000000,
      "DOGE": 1050000000,
      "XRP": 780000000
    }
  ],
  "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