Symbol Timeseries

Dev

GET /hip3-analytics/timeseries/symbol

Volume, fee, and liquidation timeseries for one HIP-3 symbol on a specific DEX. Use it to chart how trading activity on a particular token has evolved on a builder DEX, or compare activity between periods.

Liquidation metrics use only the liquidated user's fill (liq_user IS NOT NULL and trader = liq_user), excluding counterparty fills so count/value are not doubled.

Authentication

Requires Dev tier or higher.

Parameters

Query parameters

Name	Type	Required	Description
`dex_name`	string	✓	HIP-3 DEX identifier. Use with symbol. Alternatively, use coin=dex:symbol format.
`symbol`	string	✓	Symbol name. Use with dex_name.
`range`	string	–	4h, 1d, 7d, 30d, or all. Defaults to all. Legacy period is accepted until July 21, 2026.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip3-analytics/timeseries/symbol?dex_name=hyperliquid_dex&symbol=BTC&range=7d"

Example response

json

{
  "success": true,
  "range": "7d",
  "period": "1w",
  "dex_name": "hyperliquid_dex",
  "symbol": "BTC",
  "data": [
    {
      "date": "2026-06-01",
      "volume": 14200000,
      "total_fees": 7100,
      "trade_count": 2840,
      "unique_users": 420,
      "liquidation_count": 12,
      "liquidation_value_usd": 3800000
    },
    {
      "date": "2026-06-02",
      "volume": 15800000,
      "total_fees": 7900,
      "trade_count": 3120,
      "unique_users": 460,
      "liquidation_count": 18,
      "liquidation_value_usd": 5200000
    }
  ]
}

Errors

400 — Missing required dex_name and symbol (or coin).

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