> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Withdrawal Fee

> Query withdrawal fee configuration and limits for a specific currency.

## Overview

This page documents the `GET /v1/pay/wallet/withdraw_status` endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.

## Notes

* Authentication uses the standard GatePay signed headers.
* This page documents the standard merchant endpoint.
* For shared signing rules, see [/api-reference/version/100/en/common/securityAndSignature](/api-reference/version/100/en/common/securityAndSignature).


## OpenAPI

````yaml /api-reference/version/100/en/openapi/withdraw-openapi.json GET /v1/pay/wallet/withdraw_status
openapi: 3.1.0
info:
  title: GatePay Withdrawal & Wallet API
  version: 1.0.0
  description: >-
    OpenAPI 3.1 specification for GatePay withdrawal and wallet APIs, based on
    the English withdrawal documentation. It covers batch withdrawals,
    withdrawal status query, supported chains by currency, total balance query,
    and withdrawal fee query.
servers:
  - url: https://openplatform.gateapi.io
    description: Production
security: []
paths:
  /v1/pay/wallet/withdraw_status:
    get:
      tags:
        - wallet
      summary: Query withdrawal fee
      description: Query withdrawal fee configuration and limits for a specific currency.
      operationId: getWithdrawStatus
      parameters:
        - $ref: '#/components/parameters/X-GatePay-Certificate-ClientId'
        - $ref: '#/components/parameters/X-GatePay-Signature'
        - $ref: '#/components/parameters/X-GatePay-Timestamp'
        - $ref: '#/components/parameters/X-GatePay-Nonce'
        - name: currency
          in: query
          required: true
          schema:
            type: string
          description: Specify currency name.
      responses:
        '200':
          description: >-
            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>
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WithdrawStatus'
              examples:
                success:
                  summary: Successful response
                  value:
                    - currency: GT
                      name: GateToken
                      name_cn: GateToken
                      deposit: '0'
                      withdraw_percent: 0%
                      withdraw_fix: '0.01'
                      withdraw_day_limit: '20000'
                      withdraw_day_limit_remain: '20000'
                      withdraw_amount_mini: '0.11'
                      withdraw_eachtime_limit: '20000'
                      withdraw_fix_on_chains:
                        BTC: '20'
                        ETH: '15'
                        TRX: '0'
                        EOS: '2.5'
                      withdraw_percent_on_chains:
                        ETH: 0%
                        GTEVM: 0%
components:
  parameters:
    X-GatePay-Certificate-ClientId:
      name: X-GatePay-Certificate-ClientId
      in: header
      required: true
      description: >-
        The clientId assigned when the merchant registers an application in the
        Gate merchant console.
      schema:
        type: string
        example: 4186d0c6-6a35-55a9-8dc6-5312769dbff8
    X-GatePay-Signature:
      name: X-GatePay-Signature
      in: header
      required: true
      description: >-
        Request signature. GatePay uses this signature to verify whether the
        request is valid.
      schema:
        type: string
    X-GatePay-Timestamp:
      name: X-GatePay-Timestamp
      in: header
      required: true
      description: >-
        UTC timestamp in milliseconds when the request is generated. GatePay
        will not process requests where the difference from the receive time
        exceeds 10 seconds.
      schema:
        type: string
        example: '1672905655498'
    X-GatePay-Nonce:
      name: X-GatePay-Nonce
      in: header
      required: true
      description: >-
        Random string. Must comply with HTTP header rules; recommended length is
        within 32 characters, composed of digits and letters.
      schema:
        type: string
        example: '9578'
  schemas:
    WithdrawStatus:
      type: object
      description: Withdrawal fee and limit configuration for a currency.
      properties:
        currency:
          type: string
          description: Currency symbol, e.g. BTC, ETH.
        name:
          type: string
          description: Currency name (e.g. Bitcoin, Ethereum).
        name_cn:
          type: string
          description: Chinese name of currency (e.g. Bitcoin, Ethereum).
        deposit:
          type: string
          description: Deposit fee (usually "0" as string).
        withdraw_percent:
          type: string
          description: Withdrawal fee percentage, e.g. "0.1" means 0.1%.
        withdraw_fix:
          type: string
          description: Fixed withdrawal fee, e.g. "0.0005".
        withdraw_day_limit:
          type: string
          description: Daily withdrawal limit (maximum total amount per day).
        withdraw_amount_mini:
          type: string
          description: >-
            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_remain:
          type: string
          description: Remaining daily withdrawal limit (still available amount for today).
        withdraw_eachtime_limit:
          type: string
          description: >-
            Maximum single withdrawal amount (cannot exceed this per
            transaction).
        withdraw_fix_on_chains:
          type: object
          description: >-
            Fixed withdrawal fees per chain (property: chain name, value: fee
            string).
          additionalProperties:
            type: string
        withdraw_percent_on_chains:
          type: object
          description: >-
            Percentage withdrawal fees per chain (property: chain name, value:
            percentage string).
          additionalProperties:
            type: string

````