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

_Merkl API_

Rewards an address earned per UTC day over the last 7 or 30 days (today included), in USD at the current price, per token across every chain. Built from merged roots only. Rows of private or hidden-leaderboard campaigns appear only to a caller allowed to read them. Chains the address earned on in the range whose history is not backfilled yet are not charted and are listed in `unavailableChainIds`.

### Path parameters

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

### Query parameters

- `range` (string | string): Days to chart, today (UTC) included
- `chainIds` (array): Distribution chain IDs. Omit them to get every chain.
- `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/timeline" \
  -H "x-api-key: YOUR_API_KEY"
```