跳转到主要内容
GET
/
v1
/
pay
/
wallet
/
withdrawals
提现记录查询
curl --request GET \
  --url https://openplatform.gateapi.io/v1/pay/wallet/withdrawals \
  --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>'
[
  {
    "id": "w1879219868",
    "currency": "USDT",
    "address": "THISISTESTADDRESSFORGATEPAY",
    "amount": "4.023",
    "fee": "0",
    "txid": "Internal transaction 260594131",
    "chain": "BSC",
    "timestamp": "1745220149",
    "status": "DONE",
    "withdraw_order_id": "202504211521368538928",
    "block_number": "1000",
    "fail_reason": "",
    "type": "appbankgp",
    "timestamp2": "1745220149",
    "memo": ""
  }
]

请求头

​
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

指定币种，不填则返回所有币种的提现记录。

​
withdraw_id
string

提现记录 ID（以 w 开头），如指定则查询单条记录。

​
asset_class
enum<string>

币种类型，不填默认全部。可选：SPOT（主板）、PILOT（试验区）。

可用选项:
SPOT,
PILOT
​
withdraw_order_id
string

用户自定义提现订单号，用于查询指定记录。

​
from
integer<int64>

起始时间戳（秒，Unix），默认近 7 天。查询时间范围不能超过 30 天。

​
to
integer<int64>

结束时间戳（秒，Unix），默认当前时间。

​
limit
integer

返回记录的最大条数。

​
offset
integer

返回记录偏移量（从 0 开始）。

响应

200 - application/json

提现记录列表

​
id
string

交易记录 ID。

​
txid
string

区块链交易哈希。

​
block_number
string

区块高度。

​
withdraw_order_id
string

客户端订单 ID（最长 32 字符，仅支持数字/字母/_/-/.）。

​
timestamp
string

操作时间（秒级时间戳，字符串）。

​
amount
string

提现数量。

​
fee
string

手续费数量。

​
currency
string

币种名称。

​
address
string

提现地址。

​
fail_reason
string

失败原因（仅在 status 为 CANCEL 时返回）。

​
timestamp2
string

最终状态时间：CANCEL 为取消时间；DONE 且 block_number>0 为到账时间。

​
memo
string

交易备注。

​
status
string

提现状态：DONE、CANCEL、REQUEST、MANUAL、BCODE、EXTPEND、FAIL、INVALID、VERIFY、PROCES、PEND、DMOVE、REVIEW 等。

​
chain
string

提现链名称。