DEX Detail

Dev

GET /hip3-analytics/dex-detail

Single-DEX bundle for the specified HIP-3 builder DEX — summary stats, per-symbol breakdown, timeseries, liquidation count/value, builder fee series, and priority gas series. Use it to build a dedicated page for one DEX showing all its analytics without making multiple calls.

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, 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`	int	–	Number of top symbols to include. Defaults to 10, max 20.

Example request

bash

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

Example response

json

{
  "success": true,
  "range": "1d",
  "period": "1d",
  "dex_name": "hyperliquid_dex",
  "summary": {
    "volume": 210000000,
    "total_fees": 105000,
    "trade_count": 54200,
    "unique_users": 3820,
    "liquidation_count": 210,
    "liquidation_value_usd": 98000000,
    "total_deployer_fees": 52000,
    "builder_revenue": 58000,
    "priority_gas": 2600
  },
  "by_symbol": [
    {
      "dex_name": "hyperliquid_dex",
      "symbol": "BTC",
      "volume": 98000000,
      "total_fees": 49000,
      "trade_count": 18200,
      "unique_users": 1400,
      "liquidation_count": 96,
      "liquidation_value_usd": 47000000
    },
    {
      "dex_name": "hyperliquid_dex",
      "symbol": "ETH",
      "volume": 42000000,
      "total_fees": 21000,
      "trade_count": 12400,
      "unique_users": 980,
      "liquidation_count": 52,
      "liquidation_value_usd": 22000000
    }
  ],
  "timeseries": [
    {
      "date": "2026-06-08T00:00:00",
      "volume": 210000000,
      "total_fees": 105000,
      "trade_count": 54200,
      "unique_users": 3820,
      "liquidation_count": 210,
      "liquidation_value_usd": 98000000
    }
  ],
  "builder_timeseries": [],
  "priority_gas_timeseries": [],
  "symbol_breakdown": {}
}

Errors

400 — Missing required parameter dex_name.

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