# GET /v4/users/{address}/rewards/chains/{chainId}/earned

_Merkl API_

Rewards an address earned on one chain since 00:00 UTC 30 days ago, per token and campaign. Rows of private or hidden-leaderboard campaigns appear only to a caller allowed to read them. When the route cannot answer for the chain yet, it is listed in `unavailableChainIds`. Requires an API key.

### Path parameters

- `address` (string) _(required)_: User wallet address
- `chainId` (string | number) _(required)_: Chain ID to read

### Query parameters

- `isTest` (boolean): Include test tokens

## Responses

- **200** Response for status 200

## Example request

```bash
curl -X GET "https://api.merkl.xyz//v4/users/{address}/rewards/chains/{chainId}/earned" \
  -H "x-api-key: YOUR_API_KEY"
```