Skip to main content
POST
/
account
/
withdraw
Request Withdrawal
curl --request POST \
  --url https://api.fyatu.com/api/v3/account/withdraw \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 100
}'
{ "success": true, "status": 200, "message": "Withdrawal request submitted successfully. Processing can take up to 24 hours.", "data": { "withdrawalId": "WD1A2B3C4D5E6F7G8H", "amount": 100, "fee": 2, "totalAmount": 102, "currency": "USDT", "address": "TYourTronAddressHere1234567890123", "network": "TRON", "status": "PENDING", "estimatedCompletion": "2026-01-06T10:30:00+00:00", "balance": { "available": 898, "hold": 102, "total": 1000 } }, "meta": { "requestId": "req_abc123def456", "timestamp": "2026-01-05T10:30:00+00:00" } }

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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:
CurrencyNetworks
USDTTRON, ETH, BSC, Polygon, Arbitrum, Avalanche
USDCTRON, ETH, BSC, Polygon, Arbitrum, Avalanche
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

FieldTypeRequiredDescription
amountnumberYesAmount to withdraw in USDT (before fee)

​
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

StatusDescription
PENDINGWithdrawal request submitted, awaiting processing
PROCESSINGWithdrawal is being processed on the blockchain
COMPLETEDWithdrawal completed successfully, funds sent
FAILEDWithdrawal failed, funds returned to available balance

​
Example Usage

const response = await fetch('https://api.fyatu.com/api/v3/account/withdraw', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${accessToken}`
  },
  body: JSON.stringify({
    amount: 100.00
  })
});

const { data } = await response.json();

console.log(`Withdrawal ID: ${data.withdrawalId}`);
console.log(`Amount: ${data.amount} ${data.currency}`);
console.log(`Fee: ${data.fee}`);
console.log(`Total Deducted: ${data.totalAmount}`);
console.log(`To Address: ${data.address} (${data.network})`);
console.log(`Status: ${data.status}`);
console.log(`Est. Completion: ${data.estimatedCompletion}`);

​
Error Responses

Error CodeDescription
WITHDRAWAL_ADDRESS_MISSINGNo withdrawal address registered
WITHDRAWAL_ADDRESS_UNVERIFIEDWithdrawal address not yet verified
INSUFFICIENT_BALANCENot enough available balance
WITHDRAWAL_LIMIT_EXCEEDEDDaily or monthly withdrawal limit exceeded
WALLET_INACTIVEWallet is suspended or inactive

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