当天积分增量排行榜

统计当天 UTC 00:00 以来各用户的积分增量，每 5 分钟由后台 worker 自动刷新。

GET /points/leaderboard/daily

无需认证。

Query 参数

参数	类型	必填	默认值	说明
epoch	integer	否	当前活跃 Epoch	Epoch 编号
limit	integer	否	10	返回条数，钳制在 1–50
offset	integer	否	0	分页偏移量（最小 0）

响应

{
  "success": true,
  "data": {
    "date": "2026-04-16",
    "epoch_number": 3,
    "refreshed_at": "2026-04-16T08:35:00Z",
    "total": 2840,
    "entries": [
      {
        "rank": 1,
        "user_address": "0xAbCd...1234",
        "points_today": "4230.50",
        "tier": "T3"
      },
      {
        "rank": 2,
        "user_address": "0xEfGh...5678",
        "points_today": "3810.20",
        "tier": "T2"
      }
    ]
  },
  "error": null,
  "timestamp": 1745280000
}

响应字段

字段	类型	说明
date	string	UTC 日期（YYYY-MM-DD）
epoch_number	int	数据所属 Epoch
refreshed_at	string	最近一次缓存刷新时间（精度分钟级）
total	int	当天有积分增量的用户总数（非 limit 条数）
entries	array	排行条目列表

entries[]

字段	类型	说明
rank	int	今日排名
user_address	string	用户钱包地址
points_today	Decimal	当天 UTC 00:00 至今的积分增量
tier	string | null	用户当前 Tier；未设置则为 null

刷新机制

读路径直接查询 daily_points_leaderboard 表。后台 worker 每 5 分钟刷新该表（日内增量刷新；UTC 00:00 后的首次运行做全量重建，并清除前一天的数据行）。

• 本榜单显示当天增量，不是 Epoch 累计总分。Epoch 累计排行见积分排行榜。
• 若后台 worker 尚未完成当天首次刷新，接口可能返回空列表。
• 使用 offset + limit 分页，例如第 2 页：?limit=50&offset=50。

代码示例

Python

import requests

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

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

print(f"今日排行榜 {data['date']}（刷新于 {data['refreshed_at']}）")
for e in data["entries"]:
    print(f"  #{e['rank']} {e['user_address'][:10]}...: 今日 {e['points_today']} 积分")