# API Parameters

### aggregate
**boolean**  
Set to true for the rewards to be aggregated across addresses.

### fromTime
**int64**  
*required*  
Defaults to 1678174507000  
The millisecond timestamp from which you wish to retrieve the historical stake and rewards.

### toTime
**int64**  
*required*  
Defaults to 1678779307000  
The millisecond timestamp until which you wish to retrieve the historical stake and rewards.

### timeUnit
**string**  
*enum*  
*required*  
Defaults to week  
This parameter is used to aggregate rewards. It must be one of `era`, `day`, `week`, or `month`.

Allowed:  
`era` `day` `week` `month`

### addresses
**array of strings**  
Defaults to 11VR4pF6c7kfBhfmuwwjWY3FodeYBKWx7ix2rsRCU2q6hqJ  
A list of addresses.

### accept
**string**  
*enum*  
Defaults to application/json  
Generated from available response content types

Allowed:  
`application/json` `text/plain`

# Response Codes

- **200**  List of Historical Stake & Rewards for Multiple Validators
- **400**  Invalid value for query parameter or body, or both.
- **401**  Invalid or expired token
- **404**  Not Found
- **405**  Method Not Allowed
- **429**  Rate Limit Exceeded
- **500**  Internal Server Error
- **503**  Service Unavailable

# Example Request

```shell
curl --request POST \
     --url https://svc.blockdaemon.com/reporting/staking/v1/polkadot/mainnet/validator/history \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "fromTime": 1678174507000,
  "toTime": 1678779307000,
  "timeUnit": "week",
  "addresses": [\
    "11VR4pF6c7kfBhfmuwwjWY3FodeYBKWx7ix2rsRCU2q6hqJ"\
  ]
}
'```

### Response Format
- **application/json**  
- **text/plain**
