Withdrawal

Description

Includes on-chain withdrawals and internal transfers

HTTP Request

• POST /api/v3/account/withdrawal
• Rate limit: 1/sec/UID
• Permission: UTA mgt. (read & write)

Request

curl -X POST "https://api.bitget.com/api/v3/account/withdrawal" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \
   -d '{"coin":"usdt","transferType":"internal_transfer","address":"234234242","innerToType":"uid","size":"100"}'

Request Parameters

Parameter	Type	Required	Comments
coin	String	Yes	Coin name
chain	String	No	Blockchain Network - For example, erc20, trc20, etc. - This parameter is required when transferType=on_chain - The chain name can be obtained using the Get Currency Information API.
transferType	String	Yes	Withdrawal Type on_chainOn-chain deposit internal_transferInternal transfer
address	String	Yes	Withdrawal Address - When transferType is on_chain, fill in the chain address. - When transferType is internal_transfer, fill in the UID, email, or mobile number based on innerToType.
innerToType	String	No	Internal Withdrawal Address Type uidUser ID email Email mobile Mobile phone number - If not filled, the default value is uid
areaCode	String	No	Area Code This parameter is required when innerToType = mobile
tag	String	No	Address Tag This is required for withdrawals of certain cryptocurrencies, like EOS.
size	String	Yes	Withdrawal Quantity Special Notes for Bitcoin Lightning Network Withdrawals： This parameter must exactly match the amount on the Bitcoin Lightning Network deposit invoice; The withdrawal quantity for Bitcoin Lightning Network represents the amount received, excluding fees; The quantity precision can be obtained via the "Get Currency Information" API
remark	String	No	Remark
clientOid	String	No	Client Order ID
memberCode	String	No	Member Code bithumb korbit coinone
identityType	String	No	Identity Type companyInstitutional Company user Individual User
companyName	String	No	Company Name Fill in this parameter when identity=company
firstName	String	No	First Name Fill in this parameter when identity=user
lastName	String	No	Last Name Fill in this parameter when identity=user

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730189276579,
  "data": {
    "orderId": "111111111111",
    "clientOid": "111111111111"

  }
}

Response Parameters

Parameter	Type	Comments
orderId	String	Order ID
clientOid	String	Client Order ID