查詢充值紀錄 (鏈上)

提示

• 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
> id	string	內部ID, 唯一鍵
> 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	入金來源地址, 僅當入金來自鏈上且來源地址唯一時返回地址, 其餘則返回""
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": [
            {
                "id": "1319723",
                "coin": "USDT",
                "chain": "ETH",
                "amount": "10000",
                "txID": "skip-notification-scene-test-amount-202212270944-533285-USDT",
                "status": 3,
                "toAddress": "test-amount-address",
                "tag": "",
                "depositFee": "",
                "successAt": "1672134274000",
                "confirmations": "10000",
                "txIndex": "",
                "blockHash": "",
                "batchReleaseLimit": "-1",
                "depositType": "0",
                "fromAddress": ""
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTA0NjA0MywibWF4SUQiOjEwNDYwNDN9"
    },
    "retExtInfo": {},
    "time": 1672191992512
}