用户 Tier 信息

返回当前登录用户的积分 Tier 等级。Tier 由用户的手续费 VIP 等级映射而来（user_vip_tiers.current_tier），并非由积分系统内的交易量门槛决定：

积分 Tier	VIP 等级
T1	VIP 0（或无 VIP 记录）
T2	VIP 1 / VIP 2
T3	VIP 3 / VIP 4 / VIP 5

升级路径由手续费 VIP 体系管理，积分系统只读取该映射。

GET /points/tier
Authorization: Bearer <token>

Query 参数

参数	类型	必填	说明
epoch	integer	否	Epoch 编号；默认当前

响应

{
  "success": true,
  "data": {
    "tier": "T2",
    "multiplier": "1.5",
    "min_volume": "0",
    "max_volume": null,
    "current_volume": "8500000.00",
    "next_tier": null
  },
  "error": null,
  "timestamp": 1745280000
}

响应字段

字段	类型	说明
tier	string	当前 Tier：T1 / T2 / T3（由 VIP 等级映射）
multiplier	string	该 Tier 的交易积分 Maker 费率
min_volume	string	恒为 "0"——Tier 由 VIP 映射，不设交易量门槛
max_volume	null	恒为 null
current_volume	string	用户 14 日滚动交易量（USD，来自 user_vip_tiers）
next_tier	null	恒为 null——升级路径由手续费 VIP 体系管理，此处不暴露

Tier 积分费率

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

代码示例

Python

import requests

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

resp = requests.get(
    f"{BASE_URL}/points/tier",
    headers={"Authorization": f"Bearer {JWT_TOKEN}"},
)
data = resp.json()["data"]

print(f"Tier: {data['tier']}（Maker 费率 ×{data['multiplier']}），14 日交易量: {data['current_volume']}")
# Tier 升级遵循手续费 VIP 体系；此接口的 next_tier 恒为 null。