ZEzerohash
Awards

Fund awards account

Changed on

Define the quantity, quoted currency, and asset that you plan to distribute to customers through the POST /awards/distribute endpoint.

post/awards/fund

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

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.

Request body

OR

Example request

{
  "underlying": "BTC",
  "quoted_currency": "USD",
  "quantity": "1.00"
}

Response

Successfully funded awards account. Returns the executed quote and booked trade identifiers.

Example response

{
  "message": {
    "request_id": "14f8ebb8-7530-4aa4-bef9-9d73d56313f3",
    "quote": {
      "request_id": "ce819fe8-b1d7-43bb-961c-e09ede0988d3",
      "participant_code": "CUST01",
      "quoted_currency": "USD",
      "side": "buy",
      "quantity": "1",
      "price": "11430.90",
      "quote_id": "32ad471b-824e-4f04-94ff-45c4439b4fe9",
      "expire_ts": 1568311649602,
      "account_group": "GRP001",
      "account_label": "sub_account_test",
      "obo_participant": {
        "participant_code": "CUST01",
        "account_group": "PLAT01",
        "account_label": "general"
      },
      "total_notional": "2.00",
      "underlying": "BTC",
      "asset_cost_notional": "2.00",
      "spread_notional": "2.12",
      "spread_bps": "50",
      "commission_notional": "5.00",
      "commission_bps": "25"
    },
    "trade_id": "ba97133e-ab15-4c86-86c1-86671b8420bc",
    "trade_ids_list": [
      "ba97133e-ab15-4c86-86c1-86671b8420bc",
      "ce819fe8-b1d7-43bb-961c-e09ede0988d3"
    ],
    "status": "Completed"
  }
}

Changes

  • 47cf70ae701cRevision changes
    • breaking

      removed subschema #1: RFQ Standard - Quantity subschema #2: RFQ Standard - Total from the request body oneOf list

    • breaking

      added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 to the response property oneOf list for the response status

    • info

      added subschema #1: RFQ Standard - Quantity subschema #2: RFQ Standard - Total to the request body anyOf list

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response property oneOf list for the response status