Preview Withdrawal Summary

Calculates a fee and received-amount estimate for a prospective crypto withdrawal without executing it. Use this to show the customer the fee, exchange rate, and net amount before calling POST /api/v1/wallets/withdraw with the same payload. The quote is valid for the number of seconds indicated by timer.

Prerequisites

The customer must have an active wallet for the given currency + network, and the beneficiary must exist. The source wallet is resolved internally from customerId + currency + network; if no active wallet matches, the API returns 404 WALLET_NOT_FOUND with a clear message.

amount must be at least the minLimit returned by GET /api/v1/wallets/withdraw/networks for the same currency + network. A smaller amount is rejected with 422 VALIDATION_ERROR: "Amount is less than the minimum withdrawal amount of 10 USDT."

Query Parameters

Field	Type	Description
`customerId`	`string (uuid)`	Unique identifier of the customer requesting the estimate — required

Required Fields

Field	Type	Description	Constraints
`currency`	`string`	Currency ticker of the source wallet (e.g. `USDT`)	Min: 2 · Max: 20 · Pattern: `^[A-Za-z0-9_-]+$`
`network`	`string`	Blockchain network of the source wallet (e.g. `TRC-20`)	Min: 2 · Max: 20 · Pattern: `^[A-Za-z0-9_-]+$`
`beneficiaryId`	`string (uuid)`	Saved beneficiary to send funds to	-
`amount`	`number (double)`	Gross amount to withdraw	Must be greater than 0 and at least the network's `minLimit`

Response Fields

Field	Type	Description
`data.amount`	`number`	Gross amount requested
`data.walletCode`	`string`	Currency ticker (e.g. `USDT`)
`data.network`	`string`	Network the withdrawal will use (e.g. `TRC-20`)
`data.walletAddress`	`string`	Destination on-chain address
`data.fee`	`number`	Fee that will be charged
`data.receivedAmount`	`number`	Amount the beneficiary will receive
`data.exchangeRate`	`number`	Exchange rate applied
`data.timer`	`string`	Seconds the quote remains valid
`requestId`	`string`	Unique identifier of this API request
`timestamp`	`string (date-time)`	Server timestamp of the response (UTC)

curl --location '/api/v1/wallets/withdraw/estimateFee?CustomerId=' \ --header 'X-API-Key;' \ --header 'X-Signature;' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Body-Hash;' \ --header 'Content-Type: application/json' \ --data '{ "currency": "USDT", "network": "TRC-20", "beneficiaryId": "8a1f4e62-19c7-4b83-9d05-6f2ac31de470", "amount": 25.5 }'

{ "data": { "amount": 25.5, "walletCode": "USDT", "network": "TRC-20", "walletAddress": "TNXtjoJVXzABPqawSmmX27S2iCsL3RbAhG", "fee": 1.0, "receivedAmount": 24.5, "exchangeRate": 1.0, "timer": "60" }, "requestId": "77b1d0e94ca24f38b5e6c2a7f091d354", "timestamp": "2026-08-21T10:05:38.6613092Z" }

Request

Responses