Historical Stake & Rewards of a Nominator

Parameters

address

• Type: string
• Required: Yes
• Pattern: ^1[a-zA-Z0-9]{40,50}$
• Defaults to: 11VR4pF6c7kfBhfmuwwjWY3FodeYBKWx7ix2rsRCU2q6hqJ
• A single public address to check.

fromTime

• Type: int64
• Required: Yes
• Defaults to: 1678174507000
• The millisecond timestamp from which you wish to retrieve the historical stake and rewards.

toTime

• Type: int64
• Required: Yes
• Defaults to: 1678779307000
• The millisecond timestamp until which you wish to retrieve the historical stake and rewards.

timeUnit

• Type: string
• Enum: Yes
• Required: Yes
• Defaults to: week
• This parameter is used to aggregate rewards. It must be one of era, day, week, or month.

accept

• Type: string
• Enum: Yes
• Defaults to: application/json
• Generated from available response content types
• Allowed: application/json, text/plain

HTTP Status Codes

• 200 - Historical Stake & Rewards of a Nominator
• 400 - Invalid value for path parameter address 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

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

Response Types

• application/json

  • 200, 401, 405, 429, 500, 503

• text/plain

  • 400, 404