# GET /v4/claims/earnings/{address}

_Merkl API_

Aggregate a recipient's claimed rewards into time buckets broken down by token, in USD. Supports `bucket` granularity (day/week/month, default week) and `range` window (7d/30d/all, default all).

### Path parameters

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

### Query parameters

- `chainIds` (array)
- `bucket` (string | string | string)
- `range` (string | string | string)

## Responses

- **200** Response for status 200

## Example request

```bash
curl -X GET "https://api.merkl.xyz//v4/claims/earnings/{address}" \
  -H "x-api-key: YOUR_API_KEY"
```