Sign in

v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Withdrawals

Create withdrawal request

Creates new withdrawal requests to be settled. Withdrawal requests created through the API go directly into an APPROVED state. To retrieve withdrawal account IDs use the GET /withdrawals/digital_asset_addresses and GET /withdrawals/fiat_accounts endpoints.

post/withdrawals/requests

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

Example request

{
  "client_withdrawal_request_id": "c6af3d80-1aca-4280-b96b-a9b8d7ced46a",
  "withdrawal_account_id": "146",
  "address": "2NCgV7BXXafJZ86utcYFs5m3tCpkcpLafeG",
  "account": {
    "recipient_instructions": "Invoice #123"
  },
  "participant_code": "ABCDEF",
  "beneficiary_participant_code": "BENEFI",
  "sender_participant_code": "SENDER",
  "beneficiary_first_name": "John",
  "beneficiary_last_name": "Doe",
  "beneficiary_business_name": "ACME Inc.",
  "account_group": "00SCXM",
  "account_label": "sub_account_test",
  "amount": "20.1",
  "asset": "BTC",
  "gas_price": "0.0001",
  "trade_id": "a81bc81b-dead-4e5d-abff-90865d1e13b1"
}

Response

Successfully created withdrawal request. Returns the created resource with generated IDs and timestamps.

Example response

{
  "message": {
    "id": "9084dd8f-ab9f-4f9b-a22b-49bdb4915a93",
    "withdrawal_account_id": 3709509,
    "participant_code": "ABCDEF",
    "requestor_participant_code": "ABCDEF",
    "requested_amount": "0.1004142",
    "settled_amount": "0.100414200000000000",
    "status": "APPROVED",
    "asset": "BTC",
    "account_group": "00SCXM",
    "transaction_id": "0x0c36fd59b0f48257b5cd02cdf23fd8fb8230e27c5ddd28ce02c8a6a4736da4e6",
    "requested_timestamp": 1777830138534,
    "created_timestamp": "2026-05-03T17:40:10.733Z",
    "client_withdrawal_request_id": "20aed707-3127-427d-a47e-97efc6470cb3",
    "on_chain_status": "CONFIRMED",
    "fee_amount": "0.000004021417575",
    "withdrawal_fee": "0",
    "amount_in_usd": 234.32708342365032,
    "recipient_instructions": "Invoice #123"
  }
}