Skip to main content
POST
Request Withdrawal

Overview

Request a withdrawal to your registered withdrawal address. The withdrawal currency (USDT or USDC) and network are determined by your registered withdrawal address. The funds (amount + fee) are moved from your available balance to a hold balance pending confirmation, which can take up to 24 hours.

Supported Currencies & Networks

Withdrawals support USDT and USDC on multiple networks: The currency and network are set when you register your withdrawal address.

Prerequisites

Before requesting a withdrawal, you must:
  1. Register a withdrawal address via POST /account/withdrawal-address (specify currency and network)
  2. Have your withdrawal address verified (automatic for valid addresses)
  3. Have sufficient available balance to cover amount + withdrawal fee

Request Body

How It Works

  1. Validation: System validates your withdrawal address is registered and verified
  2. Fee Calculation: Withdrawal fee is calculated based on your business fee configuration
  3. Balance Check: Ensures available balance >= amount + fee
  4. Limit Check: Validates against daily and monthly withdrawal limits
  5. Hold Funds: Moves total amount (amount + fee) from available balance to hold balance
  6. Create Transaction: Creates a PENDING withdrawal transaction record

Withdrawal Statuses

Example Usage

Error Responses

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Body

application/json
amount
number
required

Amount to withdraw in USDT (before fee)

Required range: x >= 0.01
Example:

100

Response

Withdrawal request submitted successfully

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object