查詢代理用戶信息

要使用此接口，您应该有一个代理商账户，并且在创建 API 密钥时仅勾选“代理商”权限。
代理商网站: https://affiliates.bybit.com

提示

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

HTTP 請求

GET /v5/user/aff-customer-info

請求參數

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

返回參數

參數	類型	說明
uid	string	帳戶uid
vipLevel	string	VIP等級
takerVol30Day	string	過去30天的吃單交易量. 單位: USDT. 所有下方交易量相關的字段, 包含了期貨、期權和現貨的交易量
makerVol30Day	string	過去30天的掛單交易量. 單位: USDT
tradeVol30Day	string	過去30天的總交易量. 單位: USDT
depositAmount30Day	string	過去30天的入金金額. 單位: USDT
takerVol365Day	string	過去一年的吃單交易量. 單位: USDT
makerVol365Day	string	過去一年的掛單交易量. 單位: USDT
tradeVol365Day	string	過去一年的總交易量. 單位: USDT
depositAmount365Day	string	過去一年的總入金金額. 單位: USDT
totalWalletBalance	string	資產餘額區間 1: 少於100 USDT的價值 2: 100(含) ~ 250 USDT的價值 3: 250(含) ~ 500 USDT的價值 4: 大於 500USDT的價值
depositUpdateTime	string	入金數據更新時間. UTC時間
volUpdateTime	string	交易量數據更新時間. UTC時間
KycLevel	integer	KYC等級. 0, 1, 2

---

請求示例

HTTP

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

Python

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'apikey',
  secret: 'apisecret',
});

client
  .getAffiliateUserInfo({ uid: '1513500' })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "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",
        "KycLevel": 1
    },
    "retExtInfo": {},
    "time": 1685596324508
}