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 where each column is a symbol. Use it to build a stacked area chart showing which tokens are driving a DEX's volume and how their relative contributions shift across periods.

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.
`period`	string	–	4h, 1d, 1w, 1m, or all. Defaults to 1d.
`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&period=1w"

Example response

json

{
  "success": true,
  "period": "1w",
  "dex_name": "hyperliquid_dex",
  "data": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "BTC": 14200000,
      "ETH": 6800000,
      "SOL": 3400000
    },
    {
      "timestamp": "2026-06-02T00:00:00Z",
      "BTC": 15800000,
      "ETH": 7200000,
      "SOL": 3900000
    },
    {
      "timestamp": "2026-06-03T00:00:00Z",
      "BTC": 16400000,
      "ETH": 7800000,
      "SOL": 4200000
    }
  ],
  "symbols": ["BTC", "ETH", "SOL"]
}

Errors

400 — Missing required parameter dex_name.

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