积分排行榜

返回 Epoch 内的累计积分排行榜，数据从后台定期刷新的缓存表读取。

GET /points/leaderboard

无需认证。

Query 参数

参数	类型	必填	默认值	说明
epoch	integer	否	1	Epoch 编号；默认为 Epoch 1，需显式传入以查询其他周期
type_	string	否	total	排行类型（见下表）
limit	integer	否	100	返回条数

参数名为 type_（含下划线），因为 type 是 Rust 关键字。

排行类型

值	排名依据
total	总积分（默认）
trading	交易积分（TP）
pnl	PnL 积分（PP）
holding	持仓积分（HP）
referral	推荐积分（RP）
staking	质押积分（SP）

响应

{
  "success": true,
  "data": {
    "epoch_number": 3,
    "rank_type": "total",
    "entries": [
      {
        "rank": 1,
        "user_address": "0xAbCd...1234",
        "username": "TradingKing",
        "points": "125680.50",
        "tier": "T3"
      },
      {
        "rank": 2,
        "user_address": "0xEfGh...5678",
        "username": null,
        "points": "98450.20",
        "tier": "T2"
      }
    ],
    "total": 2,
    "updated_at": "2026-04-15T12:00:00Z"
  },
  "error": null,
  "timestamp": 1745280000
}

响应字段

字段	类型	说明
epoch_number	int	排行榜所属 Epoch
rank_type	string	使用的排行类型
entries	array	排行条目列表
total	int	本次响应返回的条目数（即 entries.length，受 limit 截断）——并非上榜用户总数
updated_at	string	最后缓存刷新时间（ISO 8601）

entries[]

字段	类型	说明
rank	int	排名
user_address	string	用户钱包地址
username	string | null	用户昵称；未设置则为 null
points	Decimal	对应排行类型的积分
tier	string	用户 Tier（T1 / T2 / T3）

代码示例

Python

import requests

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

resp = requests.get(
    f"{BASE_URL}/points/leaderboard",
    params={"epoch": 3, "type_": "total", "limit": 10},
)
data = resp.json()["data"]

print(f"Epoch {data['epoch_number']} 前 {len(data['entries'])} 名")
for e in data["entries"]:
    name = e["username"] or e["user_address"][:10] + "..."
    print(f"  #{e['rank']} {name}: {e['points']} 积分 [{e['tier']}]")