Estimate Withdrawal Fee

POST

/withdrawal/fee-estimate/

Calculates the estimated fee for a cryptocurrency withdrawal. Use this endpoint to get an approximation of the fee before initiating the actual withdrawal.

Authentication

Requires OAuth 2.0 authentication with read and write scopes.

Request Body

Parameter	Type	Required	Description
amount	decimal	Yes	Amount of cryptocurrency to withdraw
currency	string	Conditional	Combined currency code (e.g., "USDTERC20"). Either currency or blockchain + token
blockchain	string	Conditional	Blockchain network (e.g., "ETH", "TRX"). Use with token instead of currency
token	string	Conditional	Token symbol (e.g., "USDT"). Use with blockchain instead of currency
address	string	No	Destination address. Improves fee accuracy (e.g., new TRC20 addresses have higher fees)

Example Request

curl -X POST {{BASE_URL}}/withdrawal/fee-estimate/ \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.50,
    "blockchain": "ETH",
    "token": "USDT"
  }'

Using currency field

curl -X POST {{BASE_URL}}/withdrawal/fee-estimate/ \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.50,
    "currency": "USDTERC20"
  }'

Response

Success Response (200 OK)

{
  "fee": "1.50",
  "token": "USDT",
  "currency": "USDTERC20",
  "blockchain": "ETH",
  "chain": "ETH",
  "is_new_address": false,
  "address_activation_fee": "0.00"
}

Response Fields

Field	Type	Description
fee	decimal	Estimated total fee amount
token	string	Token symbol
currency	string	Combined currency code
blockchain	string	Blockchain network
chain	string	Chain identifier
is_new_address	boolean	Whether the destination address has not been used before (higher fee for activation)
address_activation_fee	decimal	Additional fee for activating a new address (included in fee)

Error Responses

400 Bad Request - Invalid Currency

{
  "error": {
    "code": "invalid_currency",
    "message": "The currency created from the blockchain/token combination is not supported",
    "details": {}
  }
}

Notes

• Fees are calculated based on current network conditions and may vary when the actual withdrawal is processed
• The fee includes both the platform service fee and the blockchain network fee
• For some blockchains, fees may be higher during periods of network congestion
• Providing an address improves accuracy, especially for TRC20 where new addresses incur activation fees
• Either currency or blockchain + token must be provided