Create Crypto Withdrawal
POST
/api/v1/wallets/withdraw
X-Idempotency-Key header (duplicate submissions with the same key within the configured window are rejected).currency + network with sufficient available balance (within minLimit / maxLimit). The source wallet is resolved internally from customerId + currency + network; if no active wallet matches, the API returns 404 WALLET_NOT_FOUND with a clear message.amount must be at least the minLimit returned by GET /api/v1/wallets/withdraw/networks for the same currency + network. A smaller amount is rejected with 422 VALIDATION_ERROR: "Amount is less than the minimum withdrawal amount of 10 USDT."POST /api/v1/wallets/withdraw/estimateFee (recommended).| Field | Type | Description |
|---|---|---|
customerId | string (uuid) | Unique identifier of the customer making the withdrawal — required |
| Field | Description |
|---|---|
X-Idempotency-Key | Unique key (UUID) to make the withdrawal request idempotent. A retry with the same key within the dedup window is rejected as a duplicate. |
| Field | Type | Description | Constraints |
|---|---|---|---|
currency | string | Currency ticker of the source wallet (e.g. USDT) | Min: 2 · Max: 20 · Pattern: ^[A-Za-z0-9_-]+$ |
network | string | Blockchain network of the source wallet (e.g. TRC-20) | Min: 2 · Max: 20 · Pattern: ^[A-Za-z0-9_-]+$ |
beneficiaryId | string (uuid) | Saved beneficiary to send funds to | - |
amount | number (double) | Gross amount to withdraw | Must be greater than 0 and at least the network's minLimit |
| Field | Type | Description |
|---|---|---|
data | string | Confirmation string for the withdrawal submission (literal value "Success") |
requestId | string | Unique identifier of this API request |
timestamp | string (date-time) | Server timestamp of the response (UTC) |
Request
Query Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/wallets/withdraw?CustomerId=' \
--header 'X-Idempotency-Key;' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
"walletId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"beneficiaryId": "6d4c8b2a-9e1f-4a7d-8c3b-5f2e0a1d9c6b",
"amount": 100.5
}'Response Response Example
{
"data": "Success",
"requestId": "e30a7c185f9b4d26a81c4e0b7d2f6935",
"timestamp": "2026-08-21T10:07:52.3348816Z"
}Modified at 2026-08-22 10:18:55