返佣仪表盘

返回推荐中心汇总数据：用户推荐码、实时返佣费率、按状态与业务线拆分的佣金总额，以及下线人数统计。任何已认证钱包均可访问。

GET /api/v1/referral/dashboard
Authorization: Bearer <token>

响应

{
  "referral_code": "4DDDC2D4",
  "referral_link": "https://zanbara.app/?ref=4DDDC2D4",
  "my_rebate_rate": "0.10",
  "claimable_commission": "45.00",
  "pending_commission": "12.50",
  "total_commission": "125.50",
  "spot_commission": "40.00",
  "futures_commission": "85.50",
  "direct_traders_count": 8,
  "affiliates_count": 1,
  "last_claimed_at": "2026-04-10T08:15:00Z"
}

响应字段

字段	类型	说明
referral_code	string | null	用户的推荐码；尚未创建则为 null
referral_link	string | null	含推荐码的可直接分享链接；无推荐码时为 null
my_rebate_rate	string	由等级实时推导的返佣费率（小数形式，如 "0.10" = 10%），请求时重算
claimable_commission	string	当前可领取的佣金（chain_sync_status='synced' AND status='pending'）
pending_commission	string	已计佣但尚未批量同步上链的佣金（chain_sync_status='pending'）
total_commission	string	已在链上结算的佣金总额（chain_sync_status='synced'，不限状态）
spot_commission	string	来自现货交易的已同步佣金
futures_commission	string	来自合约交易的已同步佣金
direct_traders_count	int64	直接绑定的交易者人数（is_affiliate = false）
affiliates_count	int64	下线 affiliate 人数（is_affiliate = true）
last_claimed_at	string | null	最近一次成功领取佣金的完成时间（ISO 8601）；从未领取则为 null

所有金额字段均为 USDT 计价的十进制字符串。

my_rebate_rate 为 Starter 保底的等级费率：所有用户至少为 Starter（10%）；更高等级需同时满足邀请人数与被推荐人交易量门槛（见返佣系统概述）。

代码示例

Python

import requests

BASE_URL = "https://api.prex.world/api/v1"
JWT_TOKEN = "your_jwt_token"

resp = requests.get(
    f"{BASE_URL}/referral/dashboard",
    headers={"Authorization": f"Bearer {JWT_TOKEN}"},
)
data = resp.json()

print(f"Code: {data['referral_code']}  Link: {data['referral_link']}")
print(f"Rebate rate: {data['my_rebate_rate']}")
print(f"Claimable: {data['claimable_commission']}, Pending sync: {data['pending_commission']}")
print(f"Total: {data['total_commission']} (spot {data['spot_commission']} / futures {data['futures_commission']})")
print(f"Direct traders: {data['direct_traders_count']}, Affiliates: {data['affiliates_count']}")
print(f"Last claimed: {data['last_claimed_at']}")