查詢提現紀錄

提示

• endTime - startTime需要小於等於30天. 默認查詢最近30天的紀錄。
• 僅支持母帳號的API key

HTTP 請求

GET /v5/asset/withdraw/query-record

請求參數

參數	是否必需	類型	說明
withdrawID	false	string	提現Id
txID	false	string	交易哈希ID
coin	false	string	幣種
withdrawType	false	integer	提現類型. 0(默認): 鏈上提幣. 1: 平台內部轉帳. 2: 所有方式
startTime	false	integer	開始時間戳 (毫秒)
endTime	false	integer	結束時間戳 (毫秒)
limit	false	integer	每頁數量限制. [1, 50]. 默認: 50
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
rows	array	Object
> txID	string	交易Id，提現失敗/提現撤銷：為空
> coin	string	幣種
> chain	string	鏈名
> amount	string	提幣金額
> withdrawFee	string	提幣手續費
> status	string	提幣狀態
> toAddress	string	提現目標地址. 內部轉帳：顯示Bybit UID
> tag	string	標籤
> createTime	string	提現創建時間戳 (毫秒)
> updateTime	string	提現更新時間戳 (毫秒)
> withdrawId	string	提現Id
> withdrawType	integer	提現類型. 0: 鏈上提幣. 1: 內部轉帳
> fee	string
> tax	string
> taxRate	string
> taxType	string

---

請求示例

HTTP

GET /v5/asset/withdraw/query-record?coin=USDT&withdrawType=2&limit=2 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672194949557
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_withdrawal_records(
    coin="USDT",
    withdrawType=2,
    limit=2,
))

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'xxxxxxxxxxxxxxxxxx',
  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

client
  .getWithdrawalRecords({
    coin: 'USDT',
    withdrawType: 2,
    limit: 2,
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [
            {
                "coin": "USDC",
                "chain": "ETH",
                "amount": "41.43008",
                "txID": "0x3d7bddb797f0e86420c982c0723653b8b728fd0ec9953b6b354445848d83a185",
                "status": "success",
                "toAddress": "0xE3De6d711e0951d34777b5Cd93c827F822ee8514",
                "tag": "",
                "withdrawFee": "5",
                "createTime": "1742738305000",
                "updateTime": "1742738340000",
                "withdrawId": "131629076",
                "withdrawType": 0,
                "fee": "",
                "tax": "",
                "taxRate": "",
                "taxType": ""
            },
            {
                "coin": "USDT",
                "chain": "SOL",
                "amount": "951",
                "txID": "53j7mUftUboJ2TVb1q3zjwNi9gNGWyQ8xhEpkFovzqaTf8LzuZKzr83XjbG62TZWBkWbn27km7SD6Sc9e1BuWUfJ",
                "status": "success",
                "toAddress": "DhTEGye1vq2PPr8DPWit4HTDprnvnDiqpVHnHSY1Y82p",
                "tag": "",
                "withdrawFee": "1",
                "createTime": "1742729329000",
                "updateTime": "1742729437000",
                "withdrawId": "131603458",
                "withdrawType": 0,
                "fee": "",
                "tax": "",
                "taxRate": "",
                "taxType": ""
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTMxNjAzNDU4LCJtYXhJRCI6MTMxNjI5MDc2fQ=="
    },
    "retExtInfo": {},
    "time": 1750777316807
}