# 云验证者结算 EL 奖励

### 工作原理：

1.   **发出请求：**您可以使用 GET 请求访问 API 端点  `/api/v1/cloud/validator/el/settle/rewards` 。
2. **可选参数：**
   * **开始和结束日期（YYYY-MM-DD 格式）**：指定您想要查看奖励的日期范围（限制为一个月）。
   * **验证器索引（数组）**：列出特定的验证器以查看其奖励（如果为空，则包括所有验证器）。
   * **页数和限制：**控制每页显示的结果数。

| **Parameter name** | **Data type** | **Whether it must be passed.** | **Description**                          |
| ------------------ | ------------- | ------------------------------ | ---------------------------------------- |
| start\_date        | string        | false                          | 开始日期 (YYYY-MM-DD) (UTC + 8)              |
| end\_date          | string        | false                          | 结束日期 (YYYY-MM-DD) (UTC + 8)              |
| validator\_indexes | array         | false                          | 验证器索引列表（若为空则默认查询用户所有验证器；若不为空则查询指定验证器的数据） |
| page               | int           | false                          | 页码（默认为 1）                                |
| limit              | int           | false                          | 每页条目数（默认10，最大支持1000）                     |

**注意：请求日期限制最多为一个月**

1.  end\_date 不能大于当前日期。
2.  start\_date 不 能大于当前日期。
3. 此接口仅支持查询主网奖励数据
4. 此接口仅支持查询。当前时间节点索引在云平台上存在，并且有区块奖励数据的索引数据

**响应：**

*  如果成功，您将收到响应，其详细信息如下：

**Example:** start\_date="2023-07-01"end\_date="2023-07-03" 示例：start\_date="2023-07-01"end\_date="2023-07-03"

**Response**  响应：

| **Parameter name** | **Data type** | **Description** |
| ------------------ | ------------- | --------------- |
| pubkey             | string        | 公钥              |
| validator\_index   | int           | 验证器索引           |
| fee\_address       | string        | 缴费地址            |
| el\_reward         | string        | 大宗销售收入          |
| fee\_rate          | string        | 服务费比率           |
| user\_reward       | string        | 用户利益            |
| service\_fee       | string        | 服务费             |
| reward\_time       | string        | 区块生产时间          |
| block\_number      | int           | 区块高度            |

**Example:** 示例：

```JSON
{
    "code": "200",
    "msg": "Success",
    "data": {
        "rewards": [
            {
                "id": 1740,
                "pubkey": "0x93943bd530b79623af943a2af636f06c327203d82784fafda621439438c418bd8d26c82061bbc956fc7f0f8ddb138173",
                "validator_index": 510848,
                "fee_address": "0xade4A1e54a0efA7c0557e8fdecC714F716eD0Be6",
                "el_reward": "0.0197237331857824",
                "fee_rate": "0.3",
                "user_reward": "0.01380661323004768",
                "service_fee": "0.00591711995573472",
                "reward_time": "2023-08-07 17:45:47",
                "block_number": 17864629
            },{
                "id": 1739,
                "pubkey": "0x93943bd530b79623af943a2af636f06c327203d82784fafda621439438c418bd8d26c82061bbc956fc7f0f8ddb138173",
                "validator_index": 510848,
                "fee_address": "0xade4A1e54a0efA7c0557e8fdecC714F716eD0Be6",
                "el_reward": "0.0534498763287165",
                "fee_rate": "0.3",
                "user_reward": "0.03741491343010155",
                "service_fee": "0.01603496289861495",
                "reward_time": "2023-08-04 21:15:11",
                "block_number": 17844231
            }
        ],
        "sum_reward": "0.496150059064933",
        "sum_service_fee": "0.212635739599257"
    },
    "pagination": {
        "page": 1,
        "limit": 2,
        "total": 11
    }
}
```