Request Withdraw

POST

/v1/wallet/withdraw

Request Withdraw (Wallet)

POST /v1/wallet/withdraw. Destination must be whitelisted. requestId required. Webhook: WALLET_WITHDRAW_UPDATED.

Error codes

Business failures return status 500 and an 8-digit code (WalletErrorCode).

`code`	Meaning
`10000046`	A required field is missing or its value is not accepted. Validated fields: `requestId`, `walletId`, `currency`, `amount`, `toAccountId`
`10000065`	Duplicate `requestId` — this withdrawal was already accepted
`10000002`	No wallet matches `walletId` for this account
`10000003`	`toAccountId` does not resolve to a whitelisted destination address for this account
`10000001`	Available balance is lower than `amount`

Request

Body Params application/json

Example

{
    "requestId": "withdraw1773283349",
    "currency": "USDC",
    "amount": "10.11",
    "toAccountId": 55,
    "walletId": 3113
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/wallet/withdraw' \
--header 'API-KEY: <api-key>' \
--header 'API-SIGNATURE: <api-key>' \
--header 'API-TIMESTAMP: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "withdraw1773283349",
    "currency": "USDC",
    "amount": "10.11",
    "toAccountId": 55,
    "walletId": 3113
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Examples

P0 SuccessSuccess

{"status": 200, "code": "SUCCESS", "msg": "OK", "success": true, "traceId": "tr_w_2", "data": {"transactionId": "tx_123", "requestId": "550e8400-e29b-41d4-a716-446655440000", "status": "PROCESSING", "rfiStatus": ""}}

Delete Withdraw Whiltelist

Query Wallet Internal Transfer Detail