Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
POST /leaderboard
{
"period": "All-Time"
}
| Field | Type | Required | Description |
|---|---|---|---|
period | string | No | 24H, 7D, 30D, or All-Time (default) |
All-Time.
This dedicated endpoint depends on a healthy read replica and can return 503 while the replica
is unavailable, syncing, or behind. Honor Retry-After when provided. Do not send type: "leaderboard"
to /info.
{
"entries": [
{
"address": "0x1234567890abcdef1234567890abcdef12345678",
"accountValue": "12500.00",
"pnl": "1000.00",
"roi": "8.70",
"volume": "50000.00",
"hasGenesisBadge": true
}
],
"metadata": {
"period": "All-Time",
"computedAtMs": 1781568000000,
"periodStartMs": 0,
"periodEndMs": 1781568000000
}
}
| Field | Type | Description |
|---|---|---|
address | string | User wallet address |
accountValue | string | Current account value |
pnl | string | Profit or loss for the selected period |
roi | string | Return percentage for the selected period |
volume | string | Trading volume for the selected period |
hasGenesisBadge | boolean | null | Badge eligibility, or null when not available |
| Field | Type | Description |
|---|---|---|
period | string | Period used for the response |
computedAtMs | number | null | When the results were calculated |
periodStartMs | number | null | Start of the period, in Unix milliseconds |
periodEndMs | number | null | End of the period, in Unix milliseconds |
volume descending, then pnl descending, then address ascending to break
ties.