跳至主要内容

查詢代理用戶信息

該接口是給代理商查詢他們用戶的一些基本信息的

提示
  • 僅支持使用母帳戶uid
  • 若要查詢該接口, api key僅能擁有代理商權限, 若擁有任何其他權限想, 請移除
  • 交易量和入金金額為用戶在Bybit上的總量，與結傭無關，任何結傭相關的交易量數據，以Affiliate Portal為準。

HTTP 請求​

GET /v5/user/aff-customer-info

請求參數​

參數是否必須類型說明
uidtruestring被代理用戶的母帳戶uid

返回參數​

參數類型說明
uidstring帳戶uid
vipLevelstringVIP等級
takerVol30Daystring過去30天的吃單交易量. 單位: USDT. 所有下方交易量相關的字段, 包含了期貨、期權和現貨的交易量
makerVol30Daystring過去30天的掛單交易量. 單位: USDT
tradeVol30Daystring過去30天的總交易量. 單位: USDT
depositAmount30Daystring過去30天的入金金額. 單位: USDT
takerVol365Daystring過去一年的吃單交易量. 單位: USDT
makerVol365Daystring過去一年的掛單交易量. 單位: USDT
tradeVol365Daystring過去一年的總交易量. 單位: USDT
depositAmount365Daystring過去一年的總入金金額. 單位: USDT
totalWalletBalancestring資產餘額區間
  • 1: 少於100 USDT的價值
  • 2: 100(含) ~ 250 USDT的價值
  • 3: 250(含) ~ 500 USDT的價值
  • 4: 大於 500USDT的價值
depositUpdateTimestring入金數據更新時間. UTC時間
volUpdateTimestring交易量數據更新時間. UTC時間

請求示例​

GET /v5/user/aff-customer-info?uid=1513500 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: uQ61dcX0lSe7ygD2EA
X-BAPI-TIMESTAMP: 1685596324209
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: xxxxxx
Content-Type: application/json

響應示例​

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "uid": "1513500",
        "takerVol30Day": "10",
        "makerVol30Day": "20",
        "tradeVol30Day": "30",
        "depositAmount30Day": "90",
        "takerVol365Day": "100",
        "makerVol365Day": "500",
        "tradeVol365Day": "600",
        "depositAmount365Day": "1300",
        "totalWalletBalance": "4",
        "depositUpdateTime": "2023-06-01 05:12:04",
        "vipLevel": "99",
        "volUpdateTime": "2023-06-02 00:00:00"
    },
    "retExtInfo": {},
    "time": 1685596324508
}