ADA Rewards

Returns member (delegator) and leader (validator) rewards by epoch. We report rewards at the epoch at which it was distributed (2 epochs after the epoch the rewards were earned in). Note: Cardano rewards are paid out two epochs after the epoch in which they are earned, ~10-15 days

Max 50 accounts per request.

General features described in Rewards Overview

Parameters

delegator_addresses

• Type: array of strings
• Required: Yes
• Delegator address for which to fetch rewards

start

• Type: string
• Required: Yes
• Epoch numbers (as integers) or timestamps (as strings "YYYY-MM-DD")

end

• Type: string
• Required: Yes
• Epoch numbers (as integers) or timestamps (as strings "YYYY-MM-DD")

Response Codes

• 200: A rewards result set with metadata.
• 400: Parameter error
• 401: Unauthorized
• 500: System error

Example Request

curl --request POST \  
     --url https://api.figment.io/cardano/rewards \  
     --header 'accept: application/json' \  
     --header 'content-type: application/json' \  
     --header 'x-api-key: your-api-key-here'  

Example Response

{
  "data": [
    {
      "delegator_addresses": "stake1uxcmc9r2t7cxs0zw8qm8ztg3twvxryzghsc8eszek6kuwms23gya4",
      "validator": "pool1fqwnqk3phwa2s5thgym8dw34pv0z67m526uqprnjh93cvzxymef",
      "epoch": "417",
      "timestamp": "2023-07-21T00:00:00Z",
      "rewards": [
        {
          "text": "823.370257 ADA",
          "currency": "ADA",
          "numeric": 823370257,
          "exp": 6,
          "type": "member"
        }
      ],
      "balances": [
        {
          "text": "0",
          "currency": "ADA",
          "numeric": 0,
          "exp": 6
        }
      ],
      "stake_key_hash": "b1bc146a5fb0683c4e3836712d115b98619048bc307cc059b6adc76e"
    }
  ],

"meta": {
    "protocol": "cardano",
    "network": "mainnet",
    "time_rollup": "epoch"
  }
}