ZEzerohash
Staking

List staking rewards

Changed on

Retrieve staking reward history for a participant. Includes detailed reward information and cumulative summaries.

get/stakes/{participant_code}/rewards

Request

  • Base URL
    https://api.cert.zerohash.com
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

Path parameters

participant_codestring required
Example:XXXXXX

Participant identifier

Query parameters

assetstring
Example:ETH

Filter by specific asset

stake_idstring
Example:c761fc96-5c44-40d4-8eb2-3fcd5d06754e

Filter by specific stake ID

account_labelstring
Example:general

Filter by settlement account label

start_datestring date
Example:2025-01-01

Start date for reward history (ISO 8601 format)

end_datestring date
Example:2025-12-31

End date for reward history (ISO 8601 format)

pageinteger
Example:1

Page number for pagination

page_sizeinteger
Example:50

Number of results per page

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Response

Rewards retrieved successfully

pageinteger

Current page number

total_pagesinteger

Total number of pages

Example response

{
  "rewards": [
    {
      "reward_id": "c761fc96-5c44-40d4-8eb2-3fcd5d06754e",
      "asset": "ETH",
      "account_label": "general",
      "reward_amount": "0.025",
      "created_at": "2025-08-24T12:00:00Z",
      "cumulative_rewards_amount": "1.23456789",
      "apy_net": "3.5"
    }
  ],
  "page": 1,
  "total_pages": 1
}

Changes

  • 47cf70ae701cRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      response property rewards deprecated