Withdrawal (V2)

POST/open-api/v2/wallet/withdrawal

This method enables the withdrawal of funds from the specified wallet to an external address or a Ceffu wallet. The withdrawal endpoint is applicable only to parent Qualified wallet ID or Cosign wallet or parent Prime wallet ID. To indicate the destination address, either 'withdrawalAddress' or 'toWalletIdStr' must be provided. If the destination address is a Ceffu wallet address, the 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

Request

Header Params

open-apikey

string

required

OpenAPI key string

signature

string

required

Signature of the request

amount

string

required

Withdrawal amount

Example:

10.2

coinSymbol

string

required

Coin symbol

Example:

USDT

memo

string

optional

Memo/address tag

Example:

82486739

network

string

required

Network symbol

Example:

ETH

requestId

integer <int64>

required

Unique Identifier

Example:

1640995200000

timestamp

integer <int64>

required

Current Timestamp in millisecond

Example:

1640995200000

walletId

integer <int64>

required

Wallet id

Example:

1325589336357780500

withdrawalAddress

string

required

Withdrawal address

Example:

0x25adb98b6dacd3a8bfeec5a321daa879b401eab3

toWalletIdStr

string

required

Destination wallet id

customizeFeeAmount

string

optional

User-specified fee, now support on QW/CW for ETH, BTC, XRP, TRON network

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

Request samples

Responses

The operation succeeded(200)

Business error(200)

The client request is invalid(400)

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

Authentication failed, but the operation is not allowed(403)

Requested resource does not exist(404)

Client request rate exceeded the limit(429)

System error(500)

The operation succeeded

HTTP Code: 200

Content Type : JSONapplication/json

data

optional

response data, maybe null

Any of

Withdrawal

null

orderViewId

string

required

status

enum<integer>

TransactionStatus

required

Allowed values:

1020304099

transferType

enum<integer>

TransferType

required

Allowed values:

1020

code

string

required

'000000' indicates success, while any others indicate failure.

message

string

required

When the code is '000000' (success), it represents the details of the response. Otherwise, it represents the details of the error.

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

Last modified: 2 months ago