跳至主要内容

查詢經紀商返佣信息

信息
  • 使用經紀商的母帳戶進行查詢
  • 支持查詢過去1個月的數據至T-1. 要取得1個月之前的數據, 請聯繫您的客戶經理
  • begin & end兩個入参, 要麼同時輸入, 要麼都不輸入. 当不输入时, 默认返回最近7天的数据

API頻率: 10次/秒

HTTP 請求

GET /v5/broker/earnings-info

請求參數

參數是否必需類型說明
bizTypefalsestring業務類型. SPOT, DERIVATIVES, OPTIONS
beginfalsestring開始時間, 格式: YYYYMMDD, 比如, 20231201, 表示搜尋時間是從2023年12月1日 00:00:00 UTC (包含)
endfalsestring結束時間, 格式: YYYYMMDD, 比如, 20231201, 表示搜尋時間是結束於2023年12月2日 00:00:00 UTC (不包含)
uidfalsestring
  • 輸入子UID來查詢指定UID的具體數據
  • 要向獲得所有子UID的數據, 則不傳
limitfalseinteger每頁數量限制. [1, 1000]. 默認: 1000
cursorfalsestring游標,用於翻頁

響應參數

參數類型說明
totalEarningCatObject按照業務類型統計的總的返佣數據
> spotarrayObject. 現貨交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
>> coinstring返佣幣種
>> earningstring返佣金額
> derivativesarrayObject. 期貨交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
>> coinstring返佣幣種
>> earningstring返佣金額
> optionsarrayObject. 期權交易的返佣. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
>> coinstring返佣幣種
>> earningstring返佣金額
> totalarrayObject. 所有業務類型的返佣總和. 如果沒有對應的返佣或者沒有查詢該類型, 則返回空數組 []
>> coinstring返佣幣種
>> earningstring返佣金額
detailsarrayObject. 每個子UID以及每個業務類型的交易細節
> userIdstring子帳戶
> bizTypestring業務類型. SPOT, DERIVATIVES, OPTIONS
> symbolstring幣對名
> coinstring返佣幣種
> earningstring返佣金額
> markupEarningstring加點佣金
> baseFeeEarningstring基礎佣金
> orderIdstring訂單ID
> execTimestring訂單執行時間戳 (毫秒)
nextPageCursorstring游標,用於翻頁

請求示例

GET /v5/broker/earnings-info?begin=20231129&end=20231129&uid=117894077 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1701399431920
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: 32d2aa1bc205ddfb89849b85e2a8b7e23b1f8f69fe95d6f2cb9c87562f9086a6
Content-Type: application/json

響應示例

{
"retCode": 0,
"retMsg": "success",
"result": {
"totalEarningCat": {
"spot": [],
"derivatives": [
{
"coin": "USDT",
"earning": "0.00027844"
}
],
"options": [],
"total": [
{
"coin": "USDT",
"earning": "0.00027844"
}
]
},
"details": [
{
"userId": "117894077",
"bizType": "DERIVATIVES",
"symbol": "DOGEUSDT",
"coin": "USDT",
"earning": "0.00016166",
"markupEarning": "0.000032332",
"baseFeeEarning": "0.000129328",
"orderId": "ec2132f2-a7e0-4a0c-9219-9f3cbcd8e878",
"execTime": "1701275846033"
},
{
"userId": "117894077",
"bizType": "DERIVATIVES",
"symbol": "TRXUSDT",
"coin": "USDT",
"earning": "0.00011678",
"markupEarning": "0.000023356",
"baseFeeEarning": "0.000093424",
"orderId": "28b29c2b-ba14-450e-9ce7-3cee0c1fa6da",
"execTime": "1701245285017"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1701398193964
}