Leaderboard

Epoch leaderboard by points type. Public.

GET /points/leaderboard?epoch=3&type_=total&limit=100

Query parameters

Param	Type	Default	Description
epoch	int	1	Epoch number (does not default to the active epoch — pass it explicitly)
type_	string	total	total / trading / pnl / holding / referral / staking (note the trailing underscore)
limit	int	100

Response (data)

{
  "epoch_number": 3,
  "rank_type": "total",
  "entries": [
    { "rank": 1, "user_address": "0xabc...", "username": null, "points": "125680.50", "tier": "T3" },
    { "rank": 2, "user_address": "0xdef...", "username": null, "points": "98450.20", "tier": "T2" }
  ],
  "total": 1842,
  "updated_at": "2026-04-15T12:00:00Z"
}