For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/create-withdrawal.md.
Take committed balance back out of CeFi trading
POST/withdrawals
Takes amount of the caller's committed balance back out of CeFi trading.
No tokens move: they never left the caller's own DeFi wallet. Conductor asks the exchange to withdraw the amount and answers 202 with the withdrawal in debiting. The exchange holds the amount, releases the matching DeFi allocation and then debits it; the withdrawal settles in the background, to completed once the exchange debits it or to rejected if it refuses. Poll GET /withdrawals/{id} for the outcome.
One withdrawal per listing may be unsettled at a time: a second request for the same asset_id while the first is debiting or stranded answers 409, so a retry after a lost response cannot withdraw twice. A stranded withdrawal holds the listing until an operator resolves it.
asset_id names a DeFi listing from GET /assets whose symbol is also traded on CeFi. A CeFi listing answers 404.
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 409
- 422
- 500
- 503
CeFi withdrawal requested
Bad request
Unauthorized
Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.
Not found
Conflict
Request is well-formed but cannot be processed (e.g. leverage missing or out of range for a perp order)
Internal server error
Service unavailable