Execute quote

post

https://api.cert.zerohash.com/convert_withdraw/execute

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Execution parameters: the quote_id to execute, with optional funding_details required for ACH-funded execution flows.

quote_id

string

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_id

string

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.

funding_details

ACH funding details, required only for ACH-funded executions. Supply either an inbound_reference_id (to settle against an already-received inbound) or the external_account_id/description/bank_fee trio (to initiate a new ACH pull).

Headers

X-SCX-SIGNED

string

required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMP

string

required

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully 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.

400Bad Request

403Forbidden

404Not Found

500Internal Server Error

503Service Unavailable