Withdraw
Withdraw assets from your Bybit account. You can make an off-chain transfer if the target wallet address is from Bybit. This means that no blockchain fee will be charged.
danger
- For UTA users, please note that Bybit will merge
SPOT
account intoUNIFIED
account (est.end of Feb), so please adjust your withdrawal logic by transferring funds toFUND
account first, then call withdraw API. - How do I know if my account is a UTA account? Call this endpoint, and if
uta
=1, then it is a UTA account.
caution
- Make sure you have whitelisted your wallet address here
- Can query by the master UID's api key only
formula
feeType=0:
- withdrawPercentageFee != 0: handlingFee = inputAmount / (1 - withdrawPercentageFee) * withdrawPercentageFee + withdrawFee
- withdrawPercentageFee = 0: handlingFee = withdrawFee
feeType=1:
- withdrawPercentageFee != 0: handlingFee = withdrawFee + (inputAmount - withdrawFee) * withdrawPercentageFee
- withdrawPercentageFee = 0: handlingFee = withdrawFee
HTTP Request
POST /asset/v3/private/withdraw/create
Request Parameters
Parameter | Required | Type | Comments |
---|---|---|---|
coin | true | string | coin name |
chain | true | string | chain name |
address | true | string | Withdraw address. Please note that the address is case sensitive, so use the exact same address added in address book |
tag | false | string | Need to fill in if there is a memo/tag when adding the wallet address. Note: please do not set a tag/memo in the address book if the chain does not support tag |
amount | true | string | withdraw amounts. The minimum withdrawal amount can be obtained from the Coin Info Query API |
timestamp | true | integer | Current timestamp |
forceChain | false | integer | Force to withdraw on chain or not.
|
accountType | false | string | Select the wallet to be withdrawn from
|
feeType | false | integer | Handling fee option
|
requestId | false | string | Customised ID, globally unique, it is used for idempotent verification |
Response Parameters
Parameter | Type | Comments |
---|---|---|
id | string | Withdrawal ID |
Request Example
POST /asset/v3/private/withdraw/create HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671172758674
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 193
{
"coin": "USDT",
"chain": "ETH",
"address": "xxxxxxxxxxx",
"tag": null,
"amount": "10",
"timestamp": 1670919612851,
"forceChain": 1,
"accountType": "FUND"
}
Response Example
{
"retCode": 0,
"retMsg": "success",
"result": {
"id": "xxxxxxxxxxx"
},
"retExtInfo": {},
"time": 1671172180550
}