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

_Merkl API_

Rewards an address earned over the last 30 days, per chain, token and campaign: current settled rewards minus the rewards in the merkle root live 30 days ago. Rows of private or hidden-leaderboard campaigns appear only to a caller allowed to read them. Chains whose window-start tree cannot be read are listed in `unavailableChainIds`. Requires an API key.

### Path parameters

- `address` (string) _(required)_: User address

### Query parameters

- `chainId` (array): Filter by chain IDs
- `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/earned" \
  -H "x-api-key: YOUR_API_KEY"
```