Sign in

v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Convert and Withdraw

Execute quote

Executes a convert-and-withdraw quote. The underlying asset will be purchased and automatically withdrawn. Use the returned withdrawal_request_id with GET /withdrawals/requests/{id} to track the withdrawal.

post/convert_withdraw/execute

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 of the quote to execute, which is provided in response to a POST /convert_withdraw/rfq or GET /convert_withdraw/rfq request

withdrawal_request_idstring

Optional withdrawal request ID to associate with the execution. Used by flows that pre-create a withdrawal record and then execute a quote against it.

Example request

{
  "quote_id": "32ad471b-824e-4f04-94ff-45c4439b4fe9",
  "withdrawal_request_id": "640ee134-1e55-411d-ad2d-c924c5ccf9aa"
}

Response

Successfully executed convert-and-withdraw quote. Returns the executed quote, the booked trade_id, the trade status, and the withdrawal_request_id for tracking the on-chain withdrawal.

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": "5cd07738b861c31e3bd61467BTC1Buy1568311644602",
      "expire_ts": 1568311649602,
      "account_group": "GRP001",
      "account_label": "general",
      "obo_participant": {
        "participant_code": "20XRLH",
        "account_group": "WRD1K0",
        "account_label": "general"
      },
      "network_fee_notional": "1",
      "network_fee_quantity": "1",
      "withdrawal_fee_tiers_list": [],
      "total_notional": "2.00",
      "underlying": "BTC",
      "asset_cost_notional": "2.00",
      "withdrawal_address": "2NCgV7BXXafJZ86utcYFs5m3tCpkcpLafeG",
      "payment_processor": {
        "name": "checkout.com",
        "id": "593dd810-f051-40a9-9f26-d45280efe8f3"
      },
      "spread_notional": "0.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",
    "withdrawal_request_id": "640ee134-1e55-411d-ad2d-c924c5ccf9aa"
  }
}