Skip to main content

Estimate Withdrawal Fee

POST /withdrawal/fee-estimate/

Calculates the estimated fee for a cryptocurrency withdrawal. This endpoint allows you to get an approximation of the withdrawal fee before initiating the actual withdrawal transaction, helping users make informed decisions about their transfers.

Request Headers

HeaderDescription
AuthorizationBearer token for authentication: Bearer <access_token>
X-API-KeyAPI key for authentication (alternative to OAuth 2.0 token)

Request Parameters

ParameterTypeDescription
amountnumberThe amount of cryptocurrency to withdraw
blockchainstringThe blockchain network to use. Options: ETH, BSC, TRX, SOL, ARB, BASE, BTC, LTC, DOGE, MATIC, AVAX, XRP, ADA
tokenstringOptional. The token to withdraw. Default: USDT

Example Request

POST /withdrawal/fee-estimate/
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
"amount": 100.50,
"blockchain": "ETH",
"token": "USDT"
}

Response Parameters

ParameterTypeDescription
currencystringThe currency code used for the fee calculation (e.g., USDTERC20)
feenumberThe estimated fee amount in the same currency

Example Response

{
"currency": "USDTERC20",
"fee": 1.50
}

Error Codes

Status CodeError CodeDescription
400invalid_requestThe request was malformed or contained invalid parameters
400invalid_currencyThe currency created from the blockchain/token combination is not supported
401unauthorizedAuthentication failed or token is missing
403forbiddenInsufficient permissions to use this endpoint
422invalid_amountThe amount must be a positive number
429rate_limit_exceededToo many requests in a short period
500service_unavailableFee estimation service is temporarily unavailable

Notes

  • Fees are calculated based on current network conditions and may vary when the actual withdrawal is processed
  • Fees generally include both the Cryptofuse service fee and the blockchain network fee
  • For some blockchains, fees may be higher during periods of network congestion
  • The fee is returned in the same currency as the withdrawal
  • Currency codes are constructed based on the combination of token and blockchain (e.g., USDT on Ethereum is USDTERC20)

Fee Components

The total fee consists of:

  1. Network Fee: The cost of processing the transaction on the blockchain
  2. Service Fee: Cryptofuse's processing fee
  3. Priority Fee: Optional fee for faster processing (when applicable)

Common Currency Codes

BlockchainTokenCurrency Code
ETHUSDTUSDTERC20
TRXUSDTUSDTTRC20
BSCUSDTUSDTBSC
SOLUSDTUSDTSOL
ARBUSDTUSDTARB
BASEUSDTUSDTBASE

Example: Ethereum USDT Withdrawal Fee

POST /withdrawal/fee-estimate/
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
"amount": 500.00,
"blockchain": "ETH",
"token": "USDT"
}

Response:

{
"currency": "USDTERC20",
"fee": 2.25
}

Example: Tron USDT Withdrawal Fee

POST /withdrawal/fee-estimate/
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
"amount": 500.00,
"blockchain": "TRX",
"token": "USDT"
}

Response:

{
"currency": "USDTTRC20",
"fee": 1.00
}