Source Leaderboard

Requires API key The source leaderboard endpoint returns ranked donation subjects (currently token subjects) for a specific donation source contract. This endpoint is scoped to your developer project. If the donation source is not owned by your project, the API returns 404.

Get source leaderboard

GET /{chainId}/donationSources/{address}/subjects/leaderboard

curl "https://api.donate.gg/api/v1/{chainId}/donationSources/{address}/subjects/leaderboard?limit=25" \
  -H "donate-api-key: YOUR_API_KEY"

Path parameters

Parameter	Type	Description
`chainId`	integer	Chain ID where the donation source is deployed
`address`	string	Donation source contract address (canonicalized by chain)

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" },
      "type": "token",
      "token": {
        "address": "So11...",
        "name": "Example Token",
        "symbol": "EXMP",
        "decimals": 6
      },
      "creatorAddress": "CreatorPubkey...",
      "stats": {
        "usdDonatedE6": "50000000",
        "donationCount": "10",
        "firstDonationDate": "2025-06-01T00:00:00.000Z",
        "lastDonationDate": "2026-03-15T00:00:00.000Z"
      }
    }
  ]
}

Error responses

Status	Code	Description
`400`	`VALIDATION_ERROR`	Invalid chain ID, source address, or query parameters
`404`	`NOT_FOUND`	Donation source not found or does not belong to your project

Getting Started

Developer

API

Blockchain

AI & LLMs

For Non-profits

Other

Source Leaderboard

Get source leaderboard

Error responses

​Get source leaderboard

​Error responses

Get source leaderboard

Error responses