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