查詢提現紀錄

提示

• 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
> withdrawId	string	提現Id
> txID	string	交易Id，提現失敗/提現撤銷：為空
> withdrawType	integer	提現類型. 0: 鏈上提幣. 1: 內部轉帳
> coin	string	幣種
> chain	string	鏈名
> amount	string	提幣金額
> withdrawFee	string	提幣手續費
> status	string	提幣狀態
> toAddress	string	提現目標地址. 內部轉帳：顯示Bybit UID
> tag	string	標籤
> createTime	string	提現創建時間戳 (毫秒)
> updateTime	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: XXXXX
X-BAPI-TIMESTAMP: 1672194949557
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
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: 'apikey',
  secret: 'apisecret',
});

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": "USDT",
                "chain": "ETH",
                "amount": "77",
                "txID": "",
                "status": "SecurityCheck",
                "toAddress": "0x99ced129603abc771c0dabe935c326ff6c86645d",
                "tag": "",
                "withdrawFee": "10",
                "createTime": "1670922217000",
                "updateTime": "1670922217000",
                "withdrawId": "9976",
                "withdrawType": 0
            },
            {
                "coin": "USDT",
                "chain": "internalAddressChain",
                "amount": "20.1234",
                "txID": "",
                "status": "success",
                "toAddress": "999805",
                "tag": "",
                "withdrawFee": "0",
                "createTime": "1698889833000",
                "updateTime": "1698889846000",
                "withdrawId": "13310",
                "withdrawType": 1
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6OTgwMSwibWF4SUQiOjk5NzZ9"
    },
    "retExtInfo": {},
    "time": 1672194949928
}