# API Parameters

## aggregate

**boolean**  
Set to true for the rewards to be aggregated across addresses.  
**true**, **false**

## 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`

# Responses

| Code | Description |
|------|-------------|
| `200` | List of Historical Stake & Rewards for Multiple Nominators |
| `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

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

## Response Formats

**application/json**

| Code | Description |
|------|-------------|
| `200` |
| `401` |
| `405` |
| `429` |
| `500` |
| `503` |

**text/plain**

| Code | Description |
|------|-------------|
| `400` |
| `404` |