Dashboard

Dev

GET /hip3-analytics/dashboard

Combined HIP-3 dashboard payload that replaces 14+ separate calls. Returns summary totals, per-DEX stats, timeseries, liquidation count/value, builder fee series, and priority gas series — everything a HIP-3 DEX analytics dashboard needs in one request. Use it as your primary dashboard data source and drill into specific DEXes with the dex-detail endpoint.

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. Dev: range limited to 4h, 1d, and 7d. Pro: full access including 30d and all.

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.

Tier behavior

Dev: range must be 4h, 1d, or 7d.
Pro: Full access. range includes 30d and all.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip3-analytics/dashboard?range=1d"

Example response

json

{
  "success": true,
  "range": "1d",
  "period": "1d",
  "summary": {
    "volume": 482000000,
    "total_fees": 241000,
    "trade_count": 128400,
    "unique_users": 8420,
    "liquidation_count": 745,
    "liquidation_value_usd": 326118281.71,
    "total_deployer_fees": 105000,
    "builder_revenue": 125000,
    "priority_gas_total": 8300
  },
  "by_dex": [
    {
      "dex_name": "hyperliquid_dex",
      "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
    }
  ],
  "timeseries": [
    {
      "date": "2026-06-08T00:00:00",
      "volume": 482000000,
      "total_fees": 241000,
      "trade_count": 128400,
      "unique_users": 8420,
      "liquidation_count": 745,
      "liquidation_value_usd": 326118281.71
    }
  ],
  "builder_fee_timeseries": [],
  "priority_gas_timeseries": []
}

Errors

400 — Invalid range value.
403 — Dev tier attempting range=30d or range=all. Upgrade to Pro.

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