查詢充值紀錄 (鏈上)

提示

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

HTTP 請求

GET /v5/asset/deposit/query-record

請求參數

參數	是否必需	類型	說明
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: 異常充值
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: XXXXX
X-BAPI-TIMESTAMP: 1672191991544
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_deposit_records(
    coin="USDT",
))

響應示例

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [
            {
                "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"
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTA0NjA0MywibWF4SUQiOjEwNDYwNDN9"
    },
    "retExtInfo": {},
    "time": 1672191992512
}