TradePortfolio
DocsSymbol Timeseries
Docs

Symbol Timeseries

Dev

GET /markets/{symbol}/timeseries

Volume and OI timeseries for one symbol, aggregated across all exchanges and broken down per exchange. Preset ranges are relative lookbacks ending now; start+end requests an exact historical window. 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 is limited to the rolling 30-day window. Pro and Team can request exact custom windows across the full stored history.

Parameters

Path parameters

NameTypeRequiredDescription
symbolstring✓Base symbol, e.g. BTC.

Query parameters

NameTypeRequiredDescription
rangestring–Relative lookback: 1d, 7d, 30d, or 90d. Defaults to 7d. Mutually exclusive with start+end.
startstring (ISO 8601)–Exact custom range start. Must be used with end.
endstring (ISO 8601)–Exact custom range end. Must be used with start.

Tier behavior

  • Dev: range values of 1d, 7d, and 30d, or exact custom windows clamped to the rolling 30-day window.
  • Pro: range values through 90d, plus exact custom windows across the full stored history.

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

  • 400 — Invalid range, mixed range with start/end, partial custom window, or invalid date order.
  • 404 — Symbol not found in Redis snapshot.

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

Related