模拟积分计算

预计算一笔交易可获得的积分，不实际写入任何数据。

POST /points/simulate
Authorization: Bearer <token>

Query 参数

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

请求体

{
  "trade_amount": 5000.00,
  "order_type": "maker",
  "tier": 2
}

字段	类型	必填	说明
trade_amount	decimal	是	本次交易名义金额（USD）
order_type	string	是	maker 或 taker
tier	integer	否	指定 Tier 1/2/3；不填则使用用户当前 Tier

响应

{
  "success": true,
  "data": {
    "tp_estimate": "7.50",
    "tp_effective": "6.00",
    "hp_estimate": "0.00",
    "total_estimate": "6.00",
    "tier": "T2",
    "role_rate": "1.5",
    "daily_cap_status": {
      "used": "4320.00",
      "cap": 5000,
      "remaining": "680.00"
    },
    "weekly_cap_status": {
      "used": "18500.00",
      "cap": 25000,
      "remaining": "6500.00"
    }
  },
  "error": null,
  "timestamp": 1745280000
}

hp_estimate 当前恒为 "0.00"，为未来阶段占位字段。

响应字段

字段	类型	说明
tp_estimate	Decimal	未经上限限制的原始 TP
tp_effective	Decimal	应用日/周上限后的实际 TP
hp_estimate	Decimal	HP 估算（当前恒为 "0.00"）
total_estimate	Decimal	本次交易实际可得总积分
tier	string	计算所用 Tier
role_rate	string	使用的 Maker/Taker 费率
daily_cap_status.used	Decimal	今日已用 TP
daily_cap_status.cap	int	日上限（5,000）
daily_cap_status.remaining	Decimal	今日剩余 TP 配额
weekly_cap_status.used	Decimal	本周已用 TP
weekly_cap_status.cap	int	周上限（25,000）
weekly_cap_status.remaining	Decimal	本周剩余 TP 配额

TP 计算公式

TP_raw      = (trade_amount / 1000) × tier_rate
TP_effective = min(TP_raw, daily_remaining, weekly_remaining)

交易量	角色	Tier	TP
$1,000	Maker	T1	1.2
$5,000	Maker	T2	7.5
$10,000	Taker	T3	13.0

代码示例

Python

import requests

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

resp = requests.post(
    f"{BASE_URL}/points/simulate",
    headers={"Authorization": f"Bearer {JWT_TOKEN}"},
    json={"trade_amount": 5000.00, "order_type": "maker"},
)
data = resp.json()["data"]

print(f"预估 TP: {data['tp_estimate']} → 实际: {data['tp_effective']}")
print(f"今日剩余配额: {data['daily_cap_status']['remaining']}")