返佣排行榜

返回按总返佣金额排名的前 N 名推荐人。无需认证。

GET /referral/leaderboard?n=<1-50>

查询参数

参数	类型	必填	默认值	说明
n	integer	否	10	返回前 N 名（范围 1–50）

响应示例

[
  {
    "rank": 1,
    "referrer_address": "0x1234...abcd",
    "total_commission": "1234.567890",
    "computed_at": 1745280000000
  },
  {
    "rank": 2,
    "referrer_address": "0xabcd...5678",
    "total_commission": "987.654321",
    "computed_at": 1745280000000
  }
]

响应字段说明

字段	类型	说明
rank	integer	排名（1 = 返佣最高）
referrer_address	string	推荐人钱包地址
total_commission	string	累计获得的返佣总额（USDT，十进制字符串）
computed_at	int64	排行榜最后一次计算的时间戳（毫秒）

错误码

HTTP	Code	说明
400	INVALID_PARAM	n 不在 1–50 范围内
500	DB_ERROR	数据库查询失败

代码示例

Python

import requests

BASE_URL = "https://api.ztdx.io"

resp = requests.get(
    f"{BASE_URL}/referral/leaderboard",
    params={"n": 10},
)
leaderboard = resp.json()

for entry in leaderboard:
    print(f"#{entry['rank']} {entry['referrer_address']}: {entry['total_commission']} USDT")

JavaScript

const resp = await fetch("https://api.ztdx.io/referral/leaderboard?n=10");
const leaderboard = await resp.json();

for (const entry of leaderboard) {
  console.log(`#${entry.rank} ${entry.referrer_address}: ${entry.total_commission} USDT`);
}