DEX Symbol Breakdown

Dev

GET /hip3-analytics/timeseries/dex-breakdown

Per-DEX symbol breakdown timeseries — how each symbol contributes to a specific builder DEX's activity over time. Returns a time-bucketed series in wide format with volume, fee, trade, user, and liquidation fields per symbol. Use it to build stacked charts showing which tokens are driving a DEX's activity and liquidation value across 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. Free tier does not have access (returns 403).

Parameters

Query parameters

Name	Type	Required	Description
`dex_name`	string	✓	HIP-3 DEX identifier, e.g. hyperliquid_dex.
`range`	string	–	4h, 1d, 7d, 30d, or all. Defaults to 1d. Legacy period is accepted until July 21, 2026.
`top_n`	integer	–	Number of top symbols to include. Defaults to 10.

Example request

bash

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

Example response

json

{
  "success": true,
  "range": "7d",
  "period": "1w",
  "dex_name": "hyperliquid_dex",
  "data": [
    {
      "date": "2026-06-01",
      "volume_BTC": 14200000,
      "volume_ETH": 6800000,
      "volume_others": 3400000,
      "trade_count_BTC": 2840,
      "trade_count_ETH": 1620,
      "liquidation_count_BTC": 12,
      "liquidation_count_ETH": 5,
      "liquidation_count_others": 1,
      "liquidation_value_usd_BTC": 3800000,
      "liquidation_value_usd_ETH": 1100000,
      "liquidation_value_usd_others": 250000
    },
    {
      "date": "2026-06-02",
      "volume_BTC": 15800000,
      "volume_ETH": 7200000,
      "volume_others": 3900000,
      "trade_count_BTC": 3120,
      "trade_count_ETH": 1700,
      "liquidation_count_BTC": 18,
      "liquidation_count_ETH": 6,
      "liquidation_count_others": 2,
      "liquidation_value_usd_BTC": 5200000,
      "liquidation_value_usd_ETH": 1600000,
      "liquidation_value_usd_others": 390000
    }
  ],
  "symbols": ["BTC", "ETH", "others"],
  "total_symbols": 3
}

Errors

400 — Missing required parameter dex_name.

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