ZEzerohash
Liquidity

Update quote

Changed on

Updates an active quote's total (and optionally its fees) before execution. The quote_id and new total are both required.

patch/liquidity/rfq

Request

  • Base URL
    https://api.cert.zerohash.com
  • URL
    https://api.cert.zerohash.com/liquidity/rfq
  • 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

quote_idstring required

The identifier for the quote Note: this is required to execute the quote

totalstring required

The total amount of the quoted_currency requested in the quote. Only allowed to update the total field, not quantity. Must be less than or equal to the original total amount in the quote.

Example request

{
  "quote_id": "32ad471b-824e-4f04-94ff-45c4439b4fe9",
  "total": "3600.00",
  "fees": [
    {
      "name": "sample",
      "amount": "1.95",
      "type": "notional"
    }
  ]
}

Response

Successfully updated quote. Returns the updated quote envelope ({ message: {...} }).

Example response

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

Changes

  • 47cf70ae701cRevision changes
    • warning

      added the new USDC.ETH enum value to the /// response property for the response status

    • warning

      added the new USDC.ETH enum value to the /// response property for the response status

    • warning

      added the new USDC.ETH enum value to the /// response property for the response status

    • warning

      added the new USDC.ETH enum value to the /// response property for the response status

    • warning

      added the new USDC.ETH enum value to the /// response property for the response status