# GET /v4/rewards/token/total

_Merkl API_

Returns the total amount distributed for a given token. Use query parameters to specify token address and chain ID.

### Query parameters

- `page` (string | number)
- `items` (string | number)
- `chainId` (string | number) _(required)_
- `address` (string) _(required)_
- `recipient` (string)
- `excludeAddresses` (string | array)
- `test` (boolean)

## Example request

```bash
curl -X GET "https://api.merkl.xyz//v4/rewards/token/total?chainId=<chainId>&address=<address>" \
  -H "x-api-key: YOUR_API_KEY"
```