TradePortfolio
DocsSymbol Volume Timeseries
Docs

Symbol Volume Timeseries

Free

GET /volume/{symbol}/timeseries

Volume timeseries for all exchanges reporting a given base symbol, aggregated per venue. Returns clean hourly buckets for windows up to 7 days, and daily buckets for longer windows. Use it to build per-symbol volume charts, compare exchange activity on a given token, or correlate volume spikes with price and OI movements. Legacy /volume/coin remains available until July 21, 2026.

Authentication

Available on all tiers. Free tier: BTC and ETH only — requests for other symbols return 403. Dev: all symbols, 30-day max lookback. Pro: all symbols, full available historical lookback.

Parameters

Query parameters

NameTypeRequiredDescription
symbolstring✓Base symbol in the path, for example BTC or ETH.
startstring / ISO 8601–Custom range start. Date-only strings are accepted. start_date is accepted as a legacy alias.
endstring / ISO 8601–Custom range end. Date-only strings are accepted. Defaults to now when start is provided. end_date is accepted as a legacy alias.
rangestring–Preset lookback: 4h, 12h, 1d, 3d, 7d, 14d, 30d, 90d, or all. Defaults to 7d. Do not combine with start/end.

Tier behavior

  • Free: BTC and ETH only. Requests for any other symbol return 403 with required_tier: dev.
  • Dev: All symbols. Maximum 30-day lookback. Requests beyond this are clamped with a notice.
  • Pro: All symbols. Full available historical lookback.

Example request

bash
curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/volume/ETH/timeseries?start=2026-06-01&end=2026-06-15"

Example response

json
{
  "data": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "exchange": "binance",
      "volume_usd": 5800000000
    },
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "exchange": "bybit",
      "volume_usd": 2100000000
    },
    {
      "timestamp": "2026-06-02T00:00:00Z",
      "exchange": "binance",
      "volume_usd": 6200000000
    }
  ],
	  "notices": [],
	  "coin": "ETH",
	  "unit": "usd",
	  "range": "custom",
	  "resolution": "1d"
	}

Errors

  • 403 — Free tier requesting a symbol other than BTC or ETH. Upgrade to Dev.

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

Related