Sign in

v1

latestOpenAPI 3.1.02026-07-2172050.9 KB
wallet

Query withdrawal fee

Query withdrawal fee configuration and limits for a specific currency.

get/v1/pay/wallet/withdraw_status

Query parameters

currencystring required

Specify currency name.

Headers

X-GatePay-Certificate-ClientIdstring required
Example:4186d0c6-6a35-55a9-8dc6-5312769dbff8

The clientId assigned when the merchant registers an application in the Gate merchant console.

X-GatePay-Signaturestring required

Request signature. GatePay uses this signature to verify whether the request is valid.

X-GatePay-Timestampstring required
Example:1672905655498

UTC timestamp in milliseconds when the request is generated. GatePay will not process requests where the difference from the receive time exceeds 10 seconds.

X-GatePay-Noncestring required
Example:9578

Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.

Response

Withdrawal fee details. No handling fees are charged for withdrawals to a Gate addresss, whereas handling fees apply when withdrawingto a non-Gate address.

  • When you call the "Query Withdrawal Fee" interface, it retturns the handling fees required by the supported chains for the coin. Choose the chain you need.
  • Pay attention to the two parameters below:
  • [withdraw_fix_on_chains] refers to the fixed handling fee.
  • [withdraw_percent_on_chains] refers to the percentage-based handling fee (When you withdraw certain special coins, the fee is calculated as the withdrawal quantity rmultiplied by the percentage).
  • Withdrawal Handling Fee = Fixed Handling Fee + Fee Percentage >Withdrawal Quantity
  • At present, most common chains only charge a fixed handling feewhich is updated hourly.
  • Call the interface to check the handling fee every time you make awithdrawal. The handling fee is updated hourly.
</Info>
currencystring

Currency symbol, e.g. BTC, ETH.

namestring

Currency name (e.g. Bitcoin, Ethereum).

name_cnstring

Chinese name of currency (e.g. Bitcoin, Ethereum).

depositstring

Deposit fee (usually "0" as string).

withdraw_percentstring

Withdrawal fee percentage, e.g. "0.1" means 0.1%.

withdraw_fixstring

Fixed withdrawal fee, e.g. "0.0005".

withdraw_day_limitstring

Daily withdrawal limit (maximum total amount per day).

withdraw_amount_ministring

Minimum withdrawal amount (single withdrawal cannot be lower than this, the value is 10 for USDT_TRX, for all other currencies, it is defined by the value provided by the API).

withdraw_day_limit_remainstring

Remaining daily withdrawal limit (still available amount for today).

withdraw_eachtime_limitstring

Maximum single withdrawal amount (cannot exceed this per transaction).

withdraw_fix_on_chainsobject

Fixed withdrawal fees per chain (property: chain name, value: fee string).

withdraw_percent_on_chainsobject

Percentage withdrawal fees per chain (property: chain name, value: percentage string).