查詢代理用戶信息

要使用此接口，您应该有一个代理商账户，并且在创建 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天的入金金額, 5分鐘內更新. 單位: USDT
takerVol365Day	string	過去一年的吃單交易量. 單位: USDT
makerVol365Day	string	過去一年的掛單交易量. 單位: USDT
tradeVol365Day	string	過去一年的總交易量. 單位: USDT
depositAmount365Day	string	過去一年的總入金金額, 5分鐘內更新. 單位: 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
tradfiTradeVol30Day	string	過去 30 天的 tradfi 交易量（USDT）
tradfiTradeVol365Day	string	過去一年的 tradfi 交易量（USDT）
commissions30Day	json	過去 30 天的tradfi 交易佣金
commissions365Day	json	過去一年的tradfi 交易佣金

---

請求示例

HTTP

GET /v5/user/aff-customer-info?uid=1513500 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
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: 'xxxxxxxxxxxxxxxxxx',
  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

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

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "uid": "1087997",
        "takerVol30Day": "17061.64983",
        "makerVol30Day": "10756.454142",
        "tradeVol30Day": "27818.103972",
        "depositAmount30Day": "0",
        "takerVol365Day": "1183752.53919162",
        "makerVol365Day": "44349.42819772",
        "tradeVol365Day": "1228101.96738934",
        "depositAmount365Day": "0",
        "totalWalletBalance": "4",
        "depositUpdateTime": "2026-02-04 00:00:00",
        "vipLevel": "5",
        "volUpdateTime": "2026-02-04 00:00:00",
        "KycLevel": 0,
        "tradfiTradeVol30Day": "1828890.6352",
        "tradfiTradeVol365Day": "1828890.6352",
        "commissions30Day": {
            "BTC": "",
            "ETH": "",
            "MNT": "2.14012088",
            "USDC": "",
            "USDT": "17.0461748"
        },
        "commissions365Day": {
            "BTC": "0.00012928",
            "ETH": "0.00099384",
            "MNT": "95.72886531",
            "USDC": "2.81382591",
            "USDT": "130.48078429"
        }
    },
    "retExtInfo": {},
    "time": 1770197061282
}