跳转到主要内容
GET
/
payment
/
open
/
institution
/
v1
/
pay
/
wallet
/
withdraw_status
提现手续费查询
curl --request GET \
  --url https://openplatform.gateapi.io/payment/open/institution/v1/pay/wallet/withdraw_status \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'
[
  {
    "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%"
    }
  }
]

​
概述

本页说明 GET /payment/open/institution/v1/pay/wallet/withdraw_status 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

​
说明

​
机构说明

  • 机构侧请求需携带 X-GatePay-On-Behalf-Of，用于指定要操作的机构子账户。

请求头

​
X-GatePay-Certificate-ClientId
string
必填

商户客户端ID，在 GatePay 平台申请获得

示例:

"4186d0c6-6a35-55a9-8dc6-5312769dbff8"

​
X-GatePay-Signature
string
必填

HMAC-SHA256签名，用于验证请求合法性

示例:

"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8a2ec24c97fa6fc5d1533dd6e968863747e1d86a45e562cbe899f9ed7e9ca7f77"

​
X-GatePay-Timestamp
string
必填

时间戳（毫秒），与服务器时间差不能超过5分钟

示例:

"1672905655498"

​
X-GatePay-Nonce
string
必填

随机数，用于防止重放攻击

示例:

"3525756760"

查询参数

​
currency
string
必填

币种名称，例如：BTC、ETH、USDT 等。

响应

200 - application/json

提现手续费详情

  • 调用「提现手续费查询」这个接口,会返回币种支持链所需要的手续费。选取需要的链就好:

  • 参考下面这俩参数:

    「withdraw_fix_on_chains」 是固定手续费 「withdraw_percent_on_chains」是百分比提现手续费用(有些特殊币种提现的时候需要用提现数量x这个百分比)

  • 提现手续费就是这两部分相加:固定费用+百分比费率*提现数量

  • 现在常用的链基本上只有这个固定费用(这里的固定费用是每小时更新的)

  • 每次提现的时候,都需要调用下这个接口,确认下手续费。手续费是每小时更新的。

​
currency
string

币种，例如：BTC, ETH

​
name
string

币种名称，例如：Bitcoin, Ethereum

​
name_cn
string

币种中文名称，例如：比特币，以太坊

​
deposit
string

充值手续费，通常为0，但这里用字符串表示，例如："0"

​
withdraw_percent
string

提现手续费率百分比，例如："0.1" 表示0.1%

​
withdraw_fix
string

固定提现手续费用，例如："0.0005"

​
withdraw_day_limit
string

日提现额度（该币种当天最大可提现总额）

​
withdraw_amount_mini
string

最少提现额度（单次提现不能低于这个值，USDT_TRX是10，其他币种最小提现额度是接口返回的值）

​
withdraw_day_limit_remain
string

剩余日提现额度（当天还能提现的总额）

​
withdraw_eachtime_limit
string

单次最多提现额度（单次提现不能超过这个值）

​
withdraw_fix_on_chains
object

多链的固定提现手续费用，对象属性为链的名称，值为固定费用字符串

​
withdraw_percent_on_chains
object

多链的百分比提现手续费用，对象属性为链的名称，值为百分比字符串