Skip to main content
Requires core scope This endpoint returns a single Charity Token with its currently active config and creator address.

Get token by address

GET /{chainId}/tokens/{address}
curl "https://www.donate.gg/api/v1/{chainId}/tokens/{address}" \
  -H "donate-api-key: YOUR_API_KEY"
Path parameters
ParameterTypeDescription
chainIdintegerSupported chain ID (see Chains)
addressstringToken address (canonicalized for the chain type)
Response
{
  "chain": { "id": 1, "name": "Ethereum", "type": "EVM" },
  "token": {
    "address": "0xA0b8...",
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6
  },
  "activeConfig": {
    "id": { "hex": "0x1234...abcd", "base58": "3xYz..." },
    "users": [],
    "charities": [{ "id": "charity_abc", "weight": "60", "...": "..." }]
  },
  "previousConfigs": [
    {
      "id": { "hex": "0xabcd...1234", "base58": "4AbC..." },
      "users": [],
      "charities": [{ "id": "charity_def", "weight": "40", "...": "..." }]
    }
  ],
  "creatorAddress": "0xCreator..."
}

Error responses

StatusCodeDescription
400VALIDATION_ERRORInvalid chain ID or token address
400CHAIN_NOT_SUPPORTEDChain is not supported
404NOT_FOUNDToken not found