跳至主要内容

查詢充值紀錄 (鏈上)

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

HTTP 請求

GET /v5/asset/deposit/query-record

請求參數

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

響應參數

參數類型說明
rowsarrayObject
> coinstring幣種
> chainstring鏈名
> amountstring充值金額
> txIDstring交易Id. 充值失敗或取消充值時為空
> statusinteger充值狀態
> toAddressstring充值的目標地址
> tagstring充值目標地址的tag
> depositFeestring充值手續費
> successAtstring最後更新時間
> confirmationsstring确认区块的数量
> txIndexstring交易序列号
> blockHashstring鏈上的哈希數
> batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
> depositTypestring入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
> fromAddressstring入金來源地址, 僅當入金來自鏈上且來源地址唯一時返回地址, 其餘則返回""
> taxDepositRecordsIdstringBybit EU(奧地利)用戶用於稅務目的, 保稅記錄id
> taxStatusintegerBybit EU(奧地利)用戶用於稅務目的
  • 0: No reporting required
  • 1: Reporting pending
  • 2: Reporting completed
  • > idstring內部ID, 唯一鍵
    nextPageCursorstring游標,用於翻頁

    請求示例

    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

    響應示例

    {
    "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
    }