banking.v1.WalletService

RequestWithdrawal

Request an on-chain withdrawal of free balance to an external address. Accepted (and reserved) as long as the unified balance covers it; it ships immediately when the chosen rail is liquid, otherwise it is queued until the treasury tops it up.

post/banking.v1.WalletService/RequestWithdrawal

Request

  • The document declares no server URL.
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

networkstring

bep20 | polygon | trc20 | ton — the rail to ship on

addressstring

destination on-chain address (validated per network)

amountstring

gross decimal USDT to debit (the fee is taken from this)

Response

Success

idstring
networkstring

bep20 | polygon | trc20 | ton

addressstring

destination address

amountstring

gross debited from the user (decimal USDT)

feestring

network fee retained (decimal USDT)

net_amountstring

amount − fee, the amount sent on-chain

statestring

queued | processing | completed | failed | cancelled

tx_refstring

on-chain reference once settled (empty otherwise)

Changes

No recorded changes to this operation across all 1 revision of this API.