Cloud Validator Settles EL Rewards

This functionality allows you to check your rewards earned through staking on the cloud platform.

How it works:

1. Make a request: You can use a GET request to the API endpoint /api/v1/cloud/validator/el/settle/rewards.

2. Optional parameters:

   • Start & End Date (YYYY-MM-DD format): Specify the date range for which you want to see rewards (limited to one month).

   • Validator Indexes (array): List specific validators to view their rewards (if empty, all your validators are included).

   • Page & Limit: Control the number of results displayed per page.

Parameter name	Data type	Whether it must be passed.	Description
start_date	string	false	Start date (YYYY-MM-DD) (UTC + 8)
end_date	string	false	End date (YYYY-MM-DD) (UTC + 8)
validator_indexes	array	false	Validator index list (if empty, query all validators of the user by default; if not empty, query the data of the specified validator)
page	int	false	Page number (default is 1)
limit	int	false	Number of entries per page (default is 10, maximum support is 1000)

Note: Request date limit is up to one month

1. end_date cannot be greater than the current date.

2. start_date cannot be greater than the current date.

3. This interface only supports querying mainnet reward data

4. This interface only supports queries. The current time node index exists on the cloud platform and there is index data for block reward data

Response:

• If successful, you'll receive a response with details like:

Example: start_date="2023-07-01"end_date="2023-07-03"

Response

Parameter name	Data type	Description
pubkey	string	Public key
validator_index	int	Validator index
fee_address	string	Fee addres
el_reward	string	Block sales revenue
fee_rate	string	Service charge ratio
user_reward	string	User benefits
service_fee	string	Service charge
reward_time	string	Block production time
block_number	int	Block height

Example:

{
    "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
    }
}