> ## Documentation Index
> Fetch the complete documentation index at: https://docs.donate.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Token by Address

> Fetch a Charity Token by chain and token address

<Badge icon="shield" color="blue" shape="pill">
  Requires <span style={{ color: '#1D4ED8', fontWeight: '800' }}>core</span> scope
</Badge>

This endpoint returns a single Charity Token with its currently active config and creator address.

## Get token by address

`GET /{chainId}/tokens/{address}`

```bash theme={null}
curl "https://www.donate.gg/api/v1/{chainId}/tokens/{address}" \
  -H "donate-api-key: YOUR_API_KEY"
```

**Path parameters**

| Parameter | Type    | Description                                         |
| --------- | ------- | --------------------------------------------------- |
| `chainId` | integer | Supported chain ID (see [Chains](/core-api/chains)) |
| `address` | string  | Token address (canonicalized for the chain type)    |

**Response**

```json theme={null}
{
  "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

| Status | Code                  | Description                       |
| ------ | --------------------- | --------------------------------- |
| `400`  | `VALIDATION_ERROR`    | Invalid chain ID or token address |
| `400`  | `CHAIN_NOT_SUPPORTED` | Chain is not supported            |
| `404`  | `NOT_FOUND`           | Token not found                   |