Sign in

v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Liquidity

Get quote

Retrieves a quote for the purchase or sale of a given asset. Exactly one of quantity or total must be supplied in the request body.

post/liquidity/rfq

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
OR
OR
OR
OR
OR
OR
OR
OR
OR

Example request

{
  "participant_code": "CUST01",
  "account_label": "general",
  "side": "buy",
  "underlying": "BTC",
  "quoted_currency": "USD",
  "quantity": "1.00"
}

Response

Successfully generated quote. Returns the quote envelope ({ message: {...} }) with pricing and an ephemeral quote_id.

Example response

{
  "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": "20XRLH",
      "account_group": "WRD1K0",
      "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"
  }
}