Leaderboard
Public leaderboards for creators, traders, and referrers. Used by the app Leaderboard page.
Base path: /api/leaderboard
Common query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
period |
string |
all |
7d, 30d, or all |
limit |
number |
100 |
Max results (capped, typically ≤ 500) |
sort |
string |
depends | Endpoint-specific (e.g. volume) |
Multichain (planned API; product decided)
When multi-chain is live, leaderboards will support:
| Parameter | Description |
|---|---|
scope=global |
Aggregate ranking across all enabled chains |
chainId=56 |
Ranking for one network only |
Today the app runs on BSC only (56).
Rewards points will also aggregate across chains; payout remains BNB on BSC at least initially.
See Networks & Multichain.
GET /api/leaderboard/creators
Top token creators by activity / volume in the selected period.
BASH
curl "https://hodl.dance/api/leaderboard/creators?period=30d&limit=20"
Includes creators across all launch paths (bonding, v2_burn, v3_direct) when their tokens appear in the period filters.
GET /api/leaderboard/traders
Top traders by USD volume (and related stats) in the period.
BASH
curl "https://hodl.dance/api/leaderboard/traders?period=7d&limit=20"
Volume is based on indexed trades (all source values: bonding curve, V2 pair, V3 pool).
GET /api/leaderboard/referrers
Top referrers / KOL-style rankings for the period.
BASH
curl "https://hodl.dance/api/leaderboard/referrers?period=all&limit=20"
Product context: KOL Program.
