Rewards API

Returns daily claimed rewards. Max 50 accounts per request.

General features described in Rewards Overview

Request Parameters

delegator_addresses

• Type: array of strings
• Required: Yes
• Description: The delegator addresses for which you want to see rewards.

start

• Type: string
• Required: Yes
• Description: Timestamps (as strings "YYYY-MM-DD")

end

• Type: string
• Required: Yes
• Description: Timestamps (as strings "YYYY-MM-DD")

Response

200 A rewards result set with metadata.

• Type: object
• Fields:
  • data: array of objects containing the following fields:
    • delegator_address: string
    • validator: string
    • timestamp: string
    • rewards: array of objects with the following fields:
      • text: string
      • currency: string
      • numeric: integer
      • exp: integer
    • balances: array of objects with the following fields:
      • text: string
      • currency: string
      • numeric: integer
      • exp: integer
  • meta: object with the following fields:
    • protocol: string
    • network: string
    • time_rollup: string

400 Parameter error

401 Unauthorized

500 System error

Example Request

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

Example Response

{
  "data": [
    {
      "delegator_address": "cosmos14p4dle9aastqyy8hasq2zev3hdkqj9crwfguf7",
      "validator": "cosmosvaloper1wqy2s6nwnxj57l0l5rdjxxr646p3al6y70435m",
      "timestamp": "2023-07-21T00:00:00Z",
      "rewards": [
        {
          "text": "0.61414845761237760744712",
          "currency": "ATOM",
          "numeric": 6.141484576123776e+23,
          "exp": 24
        }
      ],
      "balances": [
        {
          "text": "1000.07592",
          "currency": "ATOM",
          "numeric": 1000075920,
          "exp": 6
        }
      ]
    }
  ],
  "meta": {
    "protocol": "cosmos",
    "network": "cosmoshub-4",
    "time_rollup": "daily"
  }
}

Updated 3 months ago