Symbol Timeseries

Dev

GET /markets/{symbol}/timeseries

Volume and OI timeseries for one symbol, aggregated across all exchanges and broken down per exchange. Supports preset ranges or custom start/end dates. Use it to build per-symbol trend charts that compare how volume and positioning have evolved across venues.

Authentication

Requires Dev tier or higher. Dev: ranges of 1d, 7d, and 30d, or custom range up to 30 days. Pro: up to 90 days.

Parameters

Path parameters

Name	Type	Required	Description
`symbol`	string	✓	Base symbol, e.g. BTC.

Query parameters

Name	Type	Required	Description
`range`	string	–	1d, 7d, 30d, or 90d. Defaults to 7d. Mutually exclusive with start+end.
`start`	string (ISO 8601)	–	Custom range start. Use with end.
`end`	string (ISO 8601)	–	Custom range end. Use with start.

Tier behavior

Dev: Ranges of 1d, 7d, and 30d (or equivalent custom range up to 30 days).
Pro: Up to 90 days.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/markets/BTC/timeseries?range=7d"

Example response

json

{
  "symbol": "BTC",
  "range": "7d",
  "data": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "total_volume_usd": 42800000000,
      "total_oi_usd": 38000000000,
      "exchanges": {
        "binance": {
          "volume_usd": 12800000000,
          "oi_usd": 7200000000
        },
        "bybit": {
          "volume_usd": 5400000000,
          "oi_usd": 3100000000
        }
      }
    }
  ]
}

Errors

404 — Symbol not found in Redis snapshot.

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