Token Stats by Address

Public (API key optional) This endpoint returns aggregate donation stats for a single Charity Token, plus a breakdown for the active config and previous configs.

Get token stats by address

GET /{chainId}/tokens/{address}/stats

curl "https://api.donate.gg/api/v1/{chainId}/tokens/{address}/stats"

Path parameters

Parameter	Type	Description
`chainId`	integer	Supported chain ID (see Chains)
`address`	string	Token address (canonicalized for the chain type)

Query parameters

Parameter	Type	Default	Description
`includeHidden`	`"true"` \| `"false"`	`"false"`	Include hidden coins in the leaderboard used to calculate rank

Amounts, counts, and dates are independent of this option. A hidden coin has a rank when includeHidden=true; otherwise it is excluded from that leaderboard and its rank is null. Response

{
  "usdDonatedE6": "50000000",
  "donationCount": "10",
  "firstDonationDate": "2025-06-01T00:00:00.000Z",
  "lastDonationDate": "2026-03-15T00:00:00.000Z",
  "allTimeDonationRank": 12,
  "activeConfig": {
    "id": { "hex": "0x1234...abcd", "base58": "3xYz..." },
    "usdDonatedE6": "20000000",
    "donationCount": "4",
    "firstDonationDate": "2025-06-01T00:00:00.000Z",
    "lastDonationDate": "2026-01-10T00:00:00.000Z",
    "inputVolumeGrossAtomic": {
      "So11...": "12000000",
      "EPjF...": "8000000"
    }
  },
  "previousConfigs": [
    {
      "id": { "hex": "0xabcd...1234", "base58": "4AbC..." },
      "usdDonatedE6": "30000000",
      "donationCount": "6",
      "firstDonationDate": "2025-07-01T00:00:00.000Z",
      "lastDonationDate": "2026-03-15T00:00:00.000Z",
      "inputVolumeGrossAtomic": {
        "So11...": "30000000"
      }
    }
  ]
}

Field notes

Field	Type	Description
`usdDonatedE6`	string	Total donated USD in $10^{-6}$ precision (micro-dollars).
`donationCount`	string	Number of donations for this token.
`allTimeDonationRank`	integer \| null	Rank in the requested leaderboard, or `null` if excluded or it has no recorded leaderboard entry.
`activeConfig`	object	Stats for the token’s current active config.
`previousConfigs`	array	Stats for configs previously associated with the token.
`inputVolumeGrossAtomic`	object	Per-input-token gross volume map: `{ tokenAddress: atomicAmountAsString }`.

Error responses

Status	Code	Description
`400`	`VALIDATION_ERROR`	Invalid chain ID or token address
`404`	`NOT_FOUND`	Token not found (including a chain that is not the Charity Coins chain)

Getting Started

Developer

API

Blockchain

AI & LLMs

For Non-profits

Other

Token Stats by Address

Get token stats by address

Error responses

​Get token stats by address

​Error responses

Get token stats by address

Error responses