跳至主要内容

查詢充值記錄 (鏈上)

充值記錄查詢

規則
  • 開始時間和截止時間差最大限制為30天
  • 支持使用母、子帳戶的api key查詢各自的入金紀錄
  • HTTP 請求

    GET /asset/v3/private/deposit/record/query

    請求參數

    參數是否必須類型說明
    startTimefalseinteger開始時間 (精確到毫秒)。 默認為當前時間之前30天
    endTimefalseinteger結束時間 (精確到毫秒)。 默認為當前時間
    coinfalsestring幣種名:舉例,BTC。默認全部
    cursorfalsestring游標信息:用來分頁。 默認空
    limitfalseinteger每頁條數, [1, 50] 默認為50

    返回參數

    參數類型說明
    rowsarrayObject
    > coinstring充值的幣種
    > chainstring鏈名
    > amountstring充值的數量
    > txIDstring交易ID。充值失敗/取消充值:為空
    > statusint
    • 0=未知
    • 1=待確認
    • 2=上賬中
    • 3=已完成
    • 4=充值失敗
    > toAddressstring充值的目標地址
    > tagstring充值目標地址的tag
    > depositFeestring充值手續費
    > successAtstring最後更新時間
    > confirmationsstring确认区块的数量
    > txIndexstring交易序列号
    > blockHashstring鏈上的哈希數
    > batchReleaseLimitstring當前幣鏈每日充值限額. "-1"表示無限制
    > depositTypeinteger入金類型. 0: 正常充值, 10: 充值觸發每日限額, 20: 異常充值
    nextPageCursorstring游標信息:用來分頁

    請求示例

    GET /asset/v3/private/deposit/record/query?coin=USDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: xxxxxxxxxxx
    X-BAPI-API-KEY: xxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1671166430580
    X-BAPI-RECV-WINDOW: 50000

    響應示例

    {
    "retCode": 0,
    "retMsg": "success",
    "result": {
    "rows": [
    {
    "coin": "USDT",
    "chain": "ETH",
    "amount": "10000",
    "txID": "1234567890",
    "status": 3,
    "toAddress": "xxxxxxxxxxx",
    "tag": "",
    "depositFee": "",
    "successAt": "1671018256000",
    "confirmations": "10000",
    "txIndex": "",
    "blockHash": "",
    "batchReleaseLimit": "-1"
    },
    {
    "coin": "USDT",
    "chain": "ETH",
    "amount": "10000",
    "txID": "01234567890",
    "status": 3,
    "toAddress": "xxxxxxxxxxx",
    "tag": "",
    "depositFee": "",
    "successAt": "1669197900000",
    "confirmations": "10000",
    "txIndex": "",
    "blockHash": "",
    "batchReleaseLimit": "-1",
    "depositType": 0
    }
    ],
    "nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
    },
    "retExtInfo": {},
    "time": 1671166430718
    }