Create Withdrawal

Pays a member's balance out to an external address. member_id, dchain_id, amount and address are required; the asset follows from the network.

amount is what the destination receives — the fee is charged on top of it.

POST/api/withdrawalsAuth: Required

Answers 201. Quote the fee first with Withdrawal Fees — it returns the total fee and the total that will be debited for exactly this amount, network and destination.

Send your own id

client_withdrawal_id is optional, and worth sending: an id that has already been used is refused with 1001, so a repeated request cannot create a second payout.

1. Generate one id per intended payout and send it with the request.
2. If the call times out, retry with the same id — either it goes through, or 1001 means the first attempt was already accepted. The refusal is not a copy of the first response.
3. Either way, GET /api/withdrawals?member_id=…&client_withdrawal_id=… returns the payout and its current status.

Budget for the fee before you send

The member needs amount + fee on the balance, not amount. So whenever there is a fee, a payout of exactly the whole balance cannot go through.

Call Withdrawal Fees first: it returns total_fee and total_amount (= amount + total_fee) for this exact request. For a "send everything" flow, quote first and then send balance − total_fee.

Money moves off the platform

This is the one call that sends funds to an address you supply, and the token in the header authorises it on its own. Validate the destination address in your own code before calling, and keep the token server-side.

Request Body

member_idnumberRequired

The member whose balance is paid out.

dchain_idstringRequired

The network to pay out on, from List Assets. The asset is derived from it — there is no asset_id field on this call.

amountstring | numberRequired

The amount the destination receives. The fee is charged on top, so the balance is debited amount + fee. Accepted as a string or a number; send a string to avoid float rounding.

addressstringRequired

Destination address.

address_tagstring

Destination memo, for networks that use one (XRP, XLM, TON).

client_withdrawal_idstring

Your own id for this payout. Optional — but see the warning below. It is also a filter on List Withdrawals, which is how you check whether a payout landed.

Response

201, with the created payout.

The payout comes back with its id, its uuid, the fee that was applied, operation_type, and status — which starts at aml_processing. Read it back with Get Withdrawal to follow it to a terminal state.

Errors

Beyond the shared errors:

Code	Meaning
1001	A field is invalid or the object is not yours — the message names it: member_id, dchain_id, or client_withdrawal_id is not unique for owner
1003	Amount, balance or address failed validation; the message carries the detail
2066	This network needs a destination tag as well as an address
2002	The core refused the payout; the reason is in the message
2070	Payouts are switched off for the moment — retry later
3009	The core is in maintenance — retry later

POST/api/withdrawals

curl -X POST 'https://api.example.com/api/withdrawals' \
  -H 'Api-Token: YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '<body>'

BODY

{
  "member_id": 9670,
  "dchain_id": "trx",
  "amount": "65",
  "address": "TUAfePbhrtucB5oHVrwcFfZUWPKppwVDen",
  "client_withdrawal_id": "payout-2026-08-20-0001"
}

EXAMPLE RESPONSE

{
  "id": 19467,
  "client_withdrawal_id": "payout-2026-08-20-0001",
  "uuid": "13ba4403ea5b-4ca7-8fb2-367f72d3d04b",
  "member_id": 9670,
  "asset_id": "trx",
  "dchain_id": "trx",
  "amount": "65.0",
  "fee": "2.3",
  "status": "aml_processing",
  "tx_id": null,
  "destination": "TUAfePbhrtucB5oHVrwcFfZUWPKppwVDen",
  "destination_tag": null,
  "operation_type": "ON_CHAIN",
  "updated_at": "2026-08-28T14:00:00.548Z",
  "created_at": "2026-08-28T13:59:59.808Z"
}

BODY — MEMO NETWORK

{
  "member_id": 9670,
  "dchain_id": "xlm",
  "amount": "40",
  "address": "GC3KQFPP3KZVCRYMXIZOYYIQUBMJRAIJSYJV66UDVIND54LDOA7ME3LU",
  "address_tag": "3161679952272148229",
  "client_withdrawal_id": "payout-2026-08-20-0002"
}