By Symbol

Dev

GET /hip3-analytics/by-symbol

Granular HIP-3 stats broken down by symbol across all builder DEXes — volume, trade count, builder fees, and liquidation count/value per coin. Also bundled in /dashboard; use this endpoint when you need the per-symbol breakdown specifically without the rest of the dashboard payload.

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
`range`	string	–	4h, 1d, 7d, 30d, or all. Defaults to 1d. 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/by-symbol?range=1d"

Example response

json

{
  "success": true,
  "range": "1d",
  "period": "1d",
  "data": [
    {
      "dex_name": "hyperliquid_dex",
      "symbol": "BTC",
      "volume": 180000000,
      "total_fees": 90000,
      "trade_count": 42000,
      "unique_users": 3800,
      "liquidation_count": 320,
      "liquidation_value_usd": 138000000,
      "total_deployer_fees": 45000
    },
    {
      "dex_name": "hyperliquid_dex",
      "symbol": "ETH",
      "volume": 98000000,
      "total_fees": 49000,
      "trade_count": 24800,
      "unique_users": 2100,
      "liquidation_count": 180,
      "liquidation_value_usd": 76000000,
      "total_deployer_fees": 24500
    }
  ]
}