# Rewards API

Returns daily claimed rewards. Max 50 accounts per request.

## General features described in [Rewards Overview](https://docs.figment.io/docs/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

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

```json
{
  "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