Sign in

v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Staking

Create a new stake

Submit a staking request for a specific asset. The platform performs validation checks before processing the stake.

post/stakes

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.

X-Request-Idstring uuid

Optional client-supplied request ID used for tracing and idempotency. Must be a UUID v4. When omitted, zerohash generates one and returns it in the response X-Request-Id header.

Request body

participant_codestring required

Participant identifier

account_labelstring required

Settlement account label. The account must already exist for the participant.

assetstring required

Asset to stake

notionalstring required

Amount to stake in notional currency

notional_assetstring required

Currency or asset in which notional is expressed. Commonly the same as asset (e.g. ETH) or a fiat currency such as USD.

Example request

{
  "participant_code": "CUST01",
  "account_label": "general",
  "asset": "ETH",
  "notional": "35000.00",
  "notional_asset": "ETH"
}

Response

Stake successfully submitted

request_idstring

Request identifier

Example response

{
  "request_id": "8bb7e203-13e0-4208-80bc-e9fdb7faa13e",
  "message": {
    "stake_id": "c761fc96-5c44-40d4-8eb2-3fcd5d06754e",
    "participant_code": "CUST01",
    "asset": "ETH",
    "amount": "10.5",
    "status": "submitted",
    "created_at": "2025-08-24T16:00:00Z",
    "activated_at": "2025-08-25T16:00:00Z"
  }
}