积分系统概述
AXBlade 积分系统通过交易、持仓、推荐等行为奖励用户积分，积分在每个 Epoch 内累积，并在赛季末决定代币分配比例。
Base URL: https://api.ztdx.io/api/v1
Epoch 与赛季结构
Season（约 56 天）
├── Epoch 1（约 14 天）
├── Epoch 2（约 14 天）
├── Epoch 3（约 14 天）
└── Epoch 4（约 14 天）
- 每个 Epoch 持续约 14 天，积分在 Epoch 内累积。
- 每 4 个 Epoch 组成一个 Season，赛季末按加权积分比例向用户分配代币。
积分类型
| 类型 | 代码 | 触发条件 |
|---|---|---|
| 交易积分 | TP | 每笔成交后按交易量 × 费率计算 |
| PnL 积分 | PP | 平仓后基于已实现盈亏计算 |
| 持仓积分 | HP | 持仓期间每分钟按仓位价值累积 |
| 推荐积分 | RP | 被推荐人绑定后 7 天内首次达到触发交易量时发 放 |
| 质押积分 | SP | 质押代币期间持续累积 |
Tier 体系
交易积分费率随用户 Tier 不同而变化，Tier 由用户的手续费 VIP 等级映射而来（T1 = VIP 0，T2 = VIP 1–2，T3 = VIP 3–5；升级由手续费 VIP 体系管理）：
| Tier | VIP 等级 | Maker 费率 | Taker 费率 |
|---|---|---|---|
| T1 | VIP 0 | 1.2 TP / 千U | 0.8 TP / 千U |
| T2 | VIP 1–2 | 1.5 TP / 千U | 1.0 TP / 千U |
| T3 | VIP 3–5 | 2.0 TP / 千U | 1.3 TP / 千U |
Earn Level
Epoch 内的原始总积分决定用户的 Earn Level。等级权重设定用户的 Earn 理财产品申购配额（即每日申购容量的份额）——它不参与赛季代币分配：
| 等级 | 积分范围 | 权重 |
|---|---|---|
| L0 | 0 – 999 | 4 |
| L1 | 1,000 – 9,999 | 8 |
| L2 | 10,000 – 49,999 | 12 |
| L3 | 50,000 – 199,999 | 25 |
| L4 | 200,000 – 499,999 | 60 |
| L5 | 500,000+ | 120 |
代币分配公式
赛季末，将用户在本赛季各 Epoch 的积分汇总后按积分类型加权：
weighted_points = TP × 0.65 + PP × 0.20 + HP × 0.05 + RP × 0.10
share_pct = user_weighted_points / Σ(all_users_weighted_points)
token_reward = season_user_pool × share_pct
MM 池按各做市商的质量分总和按比例分配。earn_level_weight 不参与此公式——它只影响 Earn 申购配额。
领取窗口：快照后 30 天内通过 EIP-712 签名到链上合约领取。
赛季代币池
| 赛季 | Epoch 范围 | 用户池 | MM 池 |
|---|---|---|---|
| S1 | 1–4 | 35,000,000 | 20,000,000 |
| S2 | 5–8 | 25,000,000 | 16,000,000 |
| S3 | 9–12 | 20,000,000 | 13,000,000 |
| S4 | 13–16 | 20,000,000 | 13,000,000 |
| S5 | 17–20 | 20,000,000 | 13,000,000 |
| S6 | 21–24 | 30,000,000 | 25,000,000 |
认证方式
受保护接口需在 Header 携带 JWT：
Authorization: Bearer <token>
响应信封
所有积分接口的响应体均包裹在标准 ApiResponse 信封中：
{
"success": true,
"data": { ... },
"error": null,
"timestamp": 1745280000
}
出错时 success 为 false，data 为 null，error 为 { "code": "...", "message": "..." }。后续页面的响应示例均展示包裹在该信封中的 data 载荷；在代码中请读取 resp.json()["data"]。
接口列表
公开 接口（无需认证）
| 方法 | 接口 | 说明 |
|---|---|---|
| GET | /epochs | 获取 Epoch 列表 |
| GET | /points/earn-level-config | 获取 Earn Level 配置 |
| GET | /points/seasons | 获取赛季列表 |
| GET | /points/leaderboard | Epoch 累计积分排行榜 |
| GET | /points/leaderboard/daily | 当天积分增量排行榜 |
用户接口（需 JWT）
| 方法 | 接口 | 说明 |
|---|---|---|
| GET | /points | 获取用户积分汇总 |
| GET | /points/history | 获取积分历史明细 |
| GET | /points/tier | 获取用户 Tier 信息 |
| GET | /points/earn-quota | 获取 Earn Level 配额信息 |
| POST | /points/simulate | 模拟积分计算 |
| GET | /points/distribution/:season_id | 获取赛季代币分配详情 |
| POST | /points/claim/:distribution_id | 领取赛季代币（EIP-712） |