Withdraw

Submit a withdrawal request to transfer coins to an external address.

HTTP Request

POST /api/v1/spot/account/withdraw

Request Parameters

Parameter	Type	Required	Description
address	string	Yes	Withdrawal address
coinSymbol	string	Yes	Coin symbol to withdraw (e.g., USDT)
network	string	Yes	Network/chain (e.g., ETH, TRC20)
quantity	string	Yes	Withdrawal amount
pinCode	string	Yes	PIN code for verification
destinationTag	string	No	Destination tag/memo (for certain coins)
otpCode	string	No	OTP code (if 2FA enabled)

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/spot/account/withdraw" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "coinSymbol": "USDT",
    "network": "ETH",
    "quantity": "100.00",
    "pinCode": "123456"
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Withdrawal result data
> id	number	Withdrawal order ID
> coinSymbol	string	Coin symbol
> quantity	string	Withdrawal amount
> fee	string	Withdrawal fee
> address	string	Withdrawal address
> destinationTag	string	Destination tag (if applicable)
> createdAt	string	Creation time in milliseconds

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "coinSymbol": "USDT",
    "quantity": "100.00",
    "fee": "1.00",
    "address": "0x1234...",
    "createdAt": "1763459280833",
    "destinationTag": null,
    "id": 12345
  }
}

Error Codes

Code	Message
40002	Unauthorized
40005	Insufficient balance
40007	Withdrawal is restricted for 24 hours
40008	PIN code not set
40009	PIN code is required
40010	Invalid PIN code
40011	OTP code is required for KYC level 3 users
40012	Invalid OTP code
40013	OTP is not registered
40014	User email is required for OTP verification
40034	Maximum withdrawal amount is max
43003	Coin not found
43004	Withdrawal not available for this coin
43005	Minimum withdrawal amount is min
43006	Wallet not found
43008	24-hour withdrawal limit exceeded
43009	Destination tag is required for XRP
43010	Invalid network ID: id
43011	Invalid address format
50000	System error