ZEzerohash
Staking

List participant stakes

Changed on

List all stakes for a participant with optional filtering by asset, status and creation time. Time filters take full RFC3339 timestamps; the rewards endpoint instead filters by calendar date with start_date and end_date. Includes a summary of total staked value and rewards.

get/stakes/{participant_code}

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

status'submitted' | 'queued' | 'canceled' | 'broadcasted' | 'confirmed' | 'staked' | 'failed'
Example:staked

Filter by stake status

account_labelstring
Example:general

Filter by settlement account label

created_afterstring date-time
Example:2026-01-01T00:00:00Z

Only return stakes created at or after this time. RFC3339 timestamp with a time zone, for example 2026-01-01T00:00:00Z.

created_beforestring date-time
Example:2026-02-01T00:00:00Z

Only return stakes created strictly before this time. RFC3339 timestamp with a time zone. Must not be earlier than created_after.

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

Stakes retrieved successfully

request_idstring

Request identifier

pageinteger

Current page number

total_pagesinteger

Total number of pages

Example response

{
  "request_id": "req_321654987",
  "message": {
    "stakes": [
      {
        "stake_id": "c761fc96-5c44-40d4-8eb2-3fcd5d06754e",
        "participant_code": "CUST01",
        "asset": "ETH",
        "amount": "10.5",
        "status": "staked",
        "created_at": "2025-08-24T16:00:00Z",
        "activated_at": "2025-08-24T12:00:00Z",
        "account_label": "general",
        "account_group": "CUST01",
        "tx_hash": "0x3a1f9c2b7e4d5a6f8b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a"
      }
    ]
  },
  "page": 1,
  "total_pages": 1
}

Changes

  • 47cf70ae701cRevision changes
    • info

      added the new optional query request parameter created_after

    • info

      added the new optional query request parameter created_before

    • info

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

    • 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 message/stakes deprecated