Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
View public Charity Token rankings for a chain
GET /{chainId}/tokens/leaderboard
curl "https://www.donate.gg/api/v1/{chainId}/tokens/leaderboard?limit=25"
| Parameter | Type | Description |
|---|---|---|
chainId | integer | Supported chain ID (see Chains) |
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 25 | Results per page, max 100 |
cursor | string | - | Cursor from previous pageKey for next page |
sortBy | "top-donated" | "recent-donation" | "top-donated" | Sort order for leaderboard results |
includeInappropriate | "true" | "false" | "true" | Whether to include entries flagged as inappropriate |
{
"pageKey": "next_cursor_string",
"response": [
{
"rank": 1,
"chain": { "id": 101, "name": "Solana", "type": "solana" },
"token": {
"address": "So11...",
"name": "Example Token",
"symbol": "EXMP",
"decimals": 6
},
"stats": {
"usdDonatedE6": "50000000",
"donationCount": "10",
"firstDonationDate": "2025-06-01T00:00:00.000Z",
"lastDonationDate": "2026-03-15T00:00:00.000Z"
},
"creatorAddress": "CreatorPubkey..."
}
]
}
| Status | Code | Description |
|---|---|---|
400 | VALIDATION_ERROR | Invalid chain ID or query parameters |
404 | NOT_FOUND | No Charity Tokens exist on this chain |
Was this page helpful?