Leaderboard

Dev

GET /hip3-analytics/leaderboard

Trader leaderboard for HIP-3 builder DEX activity, sorted by volume or another specified metric. Returns a ranked list of traders with their volume, trade count, and other stats. Use it to surface the most active participants on HIP-3 DEXes or build a public leaderboard widget.

Authentication

Requires Dev tier or higher.

Parameters

Query parameters

Name	Type	Required	Description
`period`	string	–	4h, 1d, 1w, 1m, or all. Defaults to all.
`sort_by`	string	–	Metric to sort by. Defaults to volume.
`limit`	int	–	Number of traders to return. Defaults to 100.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/hip3-analytics/leaderboard?period=1d&limit=10"

Example response

json

{
  "success": true,
  "period": "1d",
  "sort_by": "volume",
  "traders": [
    {
      "address": "0xAbc1...def2",
      "volume_usd": 4200000,
      "trades": 842,
      "rank": 1
    },
    {
      "address": "0xBcd2...ef03",
      "volume_usd": 3800000,
      "trades": 621,
      "rank": 2
    }
  ]
}