### Please Note

- Rewards payouts are based on complete **UTC days,** with one entry per validator/delegator each day.  
- A minimum delegation of **100 ATOM** is required to start tracking a delegator.  
- Data is available only from May 1, 2025, onward.

### API Parameters

#### network  
- **Type:** string  
- **Required:** Yes  
- **Description:** The network to look up against. Defaults to mainnet.

#### type  
- **Type:** string  
- **Enum:** delegator, validator  
- **Required:** Yes  
- **Description:** Specifies the role associated with the request.

#### address  
- **Type:** string  
- **Required:** Yes  
- **Description:** The address to look up rewards for.

#### startTime  
- **Type:** number  
- **Required:** Yes  
- **Description:** Epoch-based start time for reward queries.

#### endTime  
- **Type:** number  
- **Required:** Yes  
- **Description:** Epoch-based end time for reward queries.

#### period  
- **Type:** string  
- **Enum:** raw, daily, weekly, monthly  
- **Required:** Yes  
- **Description:** The type of aggregation to apply.

#### accept  
- **Type:** string  
- **Enum:** application/json, application/x-ndjson  
- **Default:** application/json  
- **Description:** Generated from available response content types.

### Example cURL Request  
```
curl --request GET \
     --url 'https://svc.blockdaemon.com/reporting/staking/v2/cosmos/mainnet/delegator/rewards/address?period=raw' \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json'
```

### Response Codes  
- **200** OK  
- **400** Bad Request  
- **422** Validation Error