Create Withdrawal

Initiate a withdrawal of TRX or USDT to any valid TRON address. The withdrawal enters a PENDING state and is processed by the treasury signer.

POST/api/v1/withdrawRequires authentication

Requires view_balance permission

Idempotency

This endpoint supports the Idempotency-Key header. Sending the same key within 24 hours returns the original response without creating a duplicate withdrawal.

Request body

addressstringREQUIRED

Destination TRON address (base58 format)

amountnumberREQUIRED

Amount to withdraw in SUN (1 TRX = 1,000,000 SUN)Minimum: 50 TRX (50,000,000 SUN)

currencystringREQUIRED

Currency to withdrawOne of: TRXUSDT

Headers

Idempotency-KeystringOPTIONAL

Unique key to prevent duplicate withdrawals. Valid for 24 hours.

Request examples

curl -X POST https://merx.exchange/api/v1/withdraw \
  -H "X-API-Key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: wd-20260329-001" \
  -d '{
    "address": "TYourDestinationAddress",
    "amount": 50000000,
    "currency": "TRX"
  }'

Response

Returns the created withdrawal object. The status begins as PENDING and transitions to COMPLETED once the on-chain transaction confirms.

200Withdrawal created

{
  "id": "wd_a1b2c3d4",
  "status": "PENDING",
  "amount": 50000000,
  "currency": "TRX",
  "address": "TYourDestinationAddress"
}

Response fields

idstringUnique withdrawal identifier

statusstringCurrent status: PENDING, COMPLETED, or FAILED

amountnumberWithdrawal amount in SUN

currencystringTRX or USDT

addressstringDestination TRON address

400Insufficient balance or invalid address

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Available balance is less than the requested amount"
  }
}