Skip to main content
Requires core scope The Charity Tokens leaderboard returns ranked token donation stats for the selected chain.

​
Get token leaderboard

GET /{chainId}/tokens/leaderboard 
curl "https://www.donate.gg/api/v1/{chainId}/tokens/leaderboard?limit=25" \
  -H "donate-api-key: YOUR_API_KEY"
Path parameters
ParameterTypeDescription
chainIdintegerSupported chain ID (see Chains)
Query parameters
ParameterTypeDefaultDescription
limitinteger25Results per page, max 100
cursorstring-Cursor from previous pageKey for next page
Response 
{
  "pageKey": "next_cursor_string",
  "response": [
    {
      "rank": 1,
      "chain": { "id": 1, "name": "Ethereum", "type": "EVM" },
      "token": {
        "address": "0xA0b8...",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6
      },
      "stats": {
        "usdDonatedE6": "50000000",
        "donationCount": "10",
        "firstDonationDate": "2025-06-01T00:00:00.000Z",
        "lastDonationDate": "2026-03-15T00:00:00.000Z"
      },
      "creatorAddress": "0xCreator..."
    }
  ]
}

​
Error responses

StatusCodeDescription
400VALIDATION_ERRORInvalid chain ID or query parameters
404NOT_FOUNDNo Charity Coins exist on this chain
If you need project-scoped leaderboard data for a donation source you own, use Source Leaderboard.