查詢充值紀錄 (鏈上)

提示

• endTime - startTime需要小於等於30天，默認查詢最近30天的紀錄
• 支持母子帳號的API key查詢各自的充值紀錄

HTTP 請求

GET /v5/asset/deposit/query-record

請求參數

參數	是否必需	類型	說明
id	false	string	內部ID: 可用於唯一篩選入金紀錄. 當跟其他參數組合時, 具有最高優先級
txID	false	string	鏈上交易ID: 請注意2024年1月1日之前的入金紀錄, 無法通過txID來篩選
coin	false	string	幣種
startTime	false	integer	開始時間戳 (毫秒) 注意: 實際查詢時是秒級維度生效
endTime	false	integer	結束時間戳 (毫秒) 注意: 實際查詢時是秒級維度生效
limit	false	integer	每頁數量限制. [1, 50]. 默認: 50
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
rows	array	Object
> coin	string	幣種
> chain	string	鏈名
> amount	string	充值金額
> txID	string	交易Id. 充值失敗或取消充值時為空
> status	integer	充值狀態
> toAddress	string	充值的目標地址
> tag	string	充值目標地址的tag
> depositFee	string	充值手續費
> successAt	string	最後更新時間
> confirmations	string	确认区块的数量
> txIndex	string	交易序列号
> blockHash	string	鏈上的哈希數
> batchReleaseLimit	string	當前幣鏈每日充值限額. "-1"表示無限制
> depositType	string	入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
> fromAddress	string	入金來源地址, 僅當入金來自鏈上且來源地址唯一時返回地址, 其餘則返回""
> taxDepositRecordsId	string	Bybit EU（奧地利）用戶用於稅務目的, 保稅記錄id
> taxStatus	integer	Bybit EU（奧地利）用戶用於稅務目的 0: No reporting required 1: Reporting pending 2: Reporting completed
> id	string	內部ID, 唯一鍵
nextPageCursor	string	游標，用於翻頁

---

請求示例

HTTP

GET /v5/asset/deposit/query-record?coin=USDT&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672191991544
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_deposit_records(
    coin="USDT",
))

Node.js

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

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

client
  .getDepositRecords({
    coin: 'USDT'
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [
            {
                "coin": "USDT",
                "chain": "TRX",
                "amount": "999.0496",
                "txID": "04bf3fbad2fc85b107a42cfdc5ff83110092b606ca754efa0f032f8b94b3262e",
                "status": 3,
                "toAddress": "TDGYpm5zPacnEqKV34TJPuhJhHom9hcXAy",
                "tag": "",
                "depositFee": "",
                "successAt": "1742728163000",
                "confirmations": "50",
                "txIndex": "0",
                "blockHash": "000000000436ab4dabc8a4a87beb2262d2d87f6761a825494c4f1d5ae11b27e8",
                "batchReleaseLimit": "-1",
                "depositType": "0",
                "fromAddress": "TJ7hhYhVhaxNx6BPyq7yFpqZrQULL3JSdb",
                "taxDepositRecordsId": "0",
                "taxStatus": 0,
                "id": "160237231"
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTYwMjM3MjMxLCJtYXhJRCI6MTYwMjM3MjMxfQ=="
    },
    "retExtInfo": {},
    "time": 1750798211884
}