Skip to main content

Get Direct Referee List

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.

HTTP request

GET /refer/referee

Request parameters

Parameter NameRequiredTypeNotes
searchfalsestringSearch field, used to search by UID or account name
start_timefalseintQuery start time.
  • Defaults to querying data within the past year, and the query time range cannot exceed a year.
end_timefalseintQuery start time.
  • Defaults to querying data within the past year, and the query time range cannot exceed a year.
pagefalseintNumber of pagination. Default is 1
limitfalseintNumber in each page. Default is 10

Return parameters

Parameter NameTypeNotes
uidstringUser ID
account_namestringAccount name
registered_atintUser registration time
vip_levelintVIP level
bound_atintBinding time
refer_codestringReferral code
referrer_rebate_ratestringRebate rate for referrals
referee_rebate_ratestringRebate rate for referees
first_deposit_timeintFirst deposit time
first_deposit_valuestringFirst deposit value
total_deposit_valuestringTotal deposit value
first_deal_timeintFirst transaction time
first_deal_valuestringFirst transaction value
total_spot_valuestringTotal spot transaction value
total_spot_feestringTotal spot trading fee
total_spot_rebate_usdtstringTotal spot rebates(USDT)
total_spot_rebate_cetstringTotal spot rebates(CET)
total_futures_valuestringTotal futures transaction value
total_futures_feestringTotal futures trading fee
total_futures_rebate_usdtstringTotal futures rebates(USDT)
total_futures_rebate_cetstringTotal futures rebates(CET)
total_deal_valuestringTotal trading value
total_deal_feestringTotal trading fee
total_deal_rebate_usdtstringTotal referral rebates(USDT)
total_deal_rebate_cetstringTotal referral rebates(CET)

Request example

GET /refer/referee

Response example

{
"code": 0,
"data": [
{
"uid": "11228623",
"account_name": "user_001",
"registered_at": 1609459200000,
"vip_level": 2,
"bound_at": 1609545600000,
"refer_code": "ABC123",
"referrer_rebate_rate": "0.15",
"referee_rebate_rate": "0.10",
"first_deposit_time": 1609632000000,
"first_deposit_value": "1000.00",
"total_deposit_value": "5000.00",
"first_deal_time": 1609718400000,
"first_deal_value": "500.00",
"total_spot_value": "10000.00",
"total_spot_fee": "30.00",
"total_spot_rebate_usdt": "3.00",
"total_spot_rebate_cet": "1.50",
"total_futures_value": "20000.00",
"total_futures_fee": "60.00",
"total_futures_rebate_usdt": "6.00",
"total_futures_rebate_cet": "3.00",
"total_deal_value": "30000.00",
"total_deal_fee": "90.00",
"total_deal_rebate_usdt": "9.00",
"total_deal_rebate_cet": "4.50"
}
],
"pagination": {
"total": 1,
"has_next": false
},
"message": "OK"
}