Withdrawal

POST

/open-api/v2/wallet/withdrawal

This method allows funds to be withdrawn from the specified wallet to either an external address or another Ceffu wallet. The withdrawal endpoint is applicable only to a Qualified Wallet, Co-sign Wallet, or Parent Prime Wallet. To specify the destination, either withdrawalAddress or whitelistId or toWalletIdStr must be provided. If the destination is a Ceffu wallet address, whitelisted address verification will be bypassed.

IMPORTANT NOTES: The amount field in Withdrawal (v2) endpoint means withdrawal amount excluded network fee in v2, that is exact amount receiver will receive. Please use Get Withdrawal History v2 and Get Withdrawal Detail (v2) together with Withdrawal (v2).

API Key permission group : Enable Withdrawal, Enable Whitelisted Address Checking

Designated Wallet : Allow to set a designated wallet.

Request

Header Params

Body Params application/json

Example

{
    "amount": 10.2,
    "coinSymbol": "USDT",
    "memo": 82486739,
    "network": "ETH",
    "requestId": "string",
    "timestamp": 1640995200000,
    "walletId": "string",
    "withdrawalAddress": "0x25adb98b6dacd3a8bfeec5a321daa879b401eab3",
    "whitelistId": "string",
    "toWalletIdStr": "string",
    "customizeFeeAmount": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open-api/v2/wallet/withdrawal' \
--header 'open-apikey;' \
--header 'signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 10.2,
    "coinSymbol": "USDT",
    "memo": 82486739,
    "network": "ETH",
    "requestId": "string",
    "timestamp": 1640995200000,
    "walletId": "string",
    "withdrawalAddress": "0x25adb98b6dacd3a8bfeec5a321daa879b401eab3",
    "whitelistId": "string",
    "toWalletIdStr": "string",
    "customizeFeeAmount": "string"
}'

Responses

🟢200The operation succeeded

application/json

Body

Example

{
    "data": {
        "orderViewId": "24073614526151542000320001",
        "status": 10,
        "transferType": 10
    },
    "code": "000000",
    "message": "Success"
}

🟢200Business error

🟠400The client request is invalid

🟠401Authentication failed (e.g., invalid token specified by the Authorization header)

🟠403Authentication failed, but the operation is not allowed

🟠404Requested resource does not exist

🟠429Client request rate exceeded the limit

🔴500System error

Get Deposit Details

Get Withdrawal Fee (estimated)