查詢子帳號的充值紀錄 (鏈上)
僅能通過主帳號的API key來查詢子帳號的充值紀錄
提示
- endTime-- startTime需要小於等於30天. 默認查詢最近30天的紀錄
HTTP 請求
GET /v5/asset/deposit/query-sub-member-record
請求參數
| 參數 | 是否必需 | 類型 | 說明 | 
|---|---|---|---|
| id | false | string | 內部ID: 可用於唯一篩選入金紀錄. 當跟其他參數組合時, 具有最高優先級 | 
| txID | false | string | 鏈上交易ID: 請注意2024年1月1日之前的入金紀錄, 無法通過txID來篩選 | 
| subMemberId | true | string | 子帳號 | 
| 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 | 入金來源地址, 僅當入金來自鏈上且來源地址唯一時返回地址, 其餘則返回 "" | 
| > taxDepositRecordsId | string | Bybit EU(奧地利)用戶用於稅務目的, 保稅記錄id | 
| > taxStatus | integer | Bybit EU(奧地利)用戶用於稅務目的 | 
| nextPageCursor | string | 游標,用於翻頁 | 
請求示例
- HTTP
- Python
- Node.js
GET /v5/asset/deposit/query-sub-member-record?coin=USDT&limit=1&subMemberId=592334 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672192441294
X-BAPI-RECV-WINDOW: 5000
from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_sub_deposit_records(
    coin="USDT",
    limit=1,
    subMemberId=592334,
))
const { RestClientV5 } = require('bybit-api');
const client = new RestClientV5({
  testnet: true,
  key: 'xxxxxxxxxxxxxxxxxx',
  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});
client
  .getSubAccountDepositRecords({
    coin: 'USDT',
    limit: 1,
    subMemberId: '592334',
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });
響應示例
{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [],
        "nextPageCursor": ""
    },
    "retExtInfo": {},
    "time": 1672192441742
}