Token by Address - donate.gg

Public (API key optional) This endpoint returns a single Charity Token with its currently active config, previous configs, and creator address.

Get token by address

GET /{chainId}/tokens/{address}

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

Path parameters

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

Response

{
  "chain": { "id": 101, "name": "Solana", "type": "solana" },
  "token": {
    "address": "So11...",
    "name": "Example Token",
    "symbol": "EXMP",
    "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": "CreatorPubkey..."
}

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)
`503`	`PROVIDER_UNAVAILABLE`	Token metadata temporarily unavailable