Token Leaderboard

Public (API key optional) The Charity Tokens leaderboard returns ranked token donation stats for the selected chain.

Get token leaderboard

GET /{chainId}/tokens/leaderboard

curl "https://api.donate.gg/api/v1/{chainId}/tokens/leaderboard?limit=25"

Path parameters

Parameter	Type	Description
`chainId`	integer	Supported chain ID (see Chains)

Query parameters

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
`includeHidden`	`"true"` \| `"false"`	`"false"`	Include hidden items regardless of hide reasons

Hidden items are excluded by default. includeHidden=true includes them, with hidden, hiddenReasons (an array), and moderationSource (AI, ADMIN, or null) so your application can choose what to display. Unreviewed items have no reasons or source and remain visible. This replaces includeInappropriate / hideInappropriate; those options are no longer accepted. Hiding does not change donation amounts, counts, or dates. List ranks describe the requested list; the direct stats endpoint accepts the same includeHidden option and returns null rank only when excluded. Response

{
  "pageKey": "next_cursor_string",
  "response": [
    {
      "hidden": false,
      "hiddenReasons": [],
      "moderationSource": null,
      "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..."
    }
  ]
}

Error responses

Status	Code	Description
`400`	`VALIDATION_ERROR`	Invalid chain ID or query parameters
`404`	`NOT_FOUND`	No Charity Tokens exist on this chain

If you need project-scoped leaderboard data for a donation source you own, use Source Leaderboard.

Getting Started

Developer

API

Blockchain

AI & LLMs

For Non-profits

Other

Get token leaderboard

Error responses

​Get token leaderboard

​Error responses

​Related endpoint

Get token leaderboard

Error responses

Related endpoint