Earn Level 配额信息

返回当前登录用户的 Earn Level 及其 Earn 理财产品申购配额——即等级权重赋予的每日申购容量份额。该权重不影响赛季代币分配。

GET /points/earn-quota
Authorization: Bearer <token>

Query 参数

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

响应

{
  "success": true,
  "data": {
    "level": "L2",
    "weight": 12,
    "total_raw_points": "15000.00",
    "next_level_points_needed": "35000.00",
    "platform_total_effective_weight": 26400,
    "my_share_pct": "0.000454545454",
    "level_updated_at": "2026-04-16T00:00:05Z",
    "products": [
      {
        "product_id": "d4c3b2a1-...",
        "product_name": "USDT Flexible",
        "capacity": "1000000.00",
        "concentration_cap_pct": "0.05",
        "quota_today": "454.55",
        "concentration_cap_applied": false
      }
    ],
    "cross_product_quota_today": "1363.65"
  },
  "error": null,
  "timestamp": 1745280000
}

响应字段

字段	类型	说明
level	string	当前 Earn Level，形如 "L0"–"L5"
weight	int	当前等级的配额权重
total_raw_points	Decimal	本 Epoch 原始总积分（TP+PP+HP+RP，未加权）
next_level_points_needed	Decimal	距下一等级所需积分；L5 时为 "0"
platform_total_effective_weight	int64	全平台所有用户等级权重之和（取自当日快照；当日快照尚未运行时为 0）
my_share_pct	Decimal	用户占 Earn 配额权重的份额：weight / platform_total_effective_weight
level_updated_at	string	用户等级最后刷新时间（每日 UTC 00:00 刷新）
products	array	按产品拆分的配额明细；未配置任何 Earn 产品时为空数组
cross_product_quota_today	Decimal	跨产品总配额：单产品最大配额 × 跨产品倍率（默认 3）

products[]

字段	类型	说明
product_id	string	Earn 产品 UUID
product_name	string	产品展示名称
capacity	Decimal	产品每日总申购容量
concentration_cap_pct	Decimal	单用户集中度上限（占容量的比例，如 "0.05" = 5%）
quota_today	Decimal	用户今日有效配额：min(my_share_pct × capacity, capacity × concentration_cap_pct)
concentration_cap_applied	bool	集中度上限是否为实际生效的限制

Earn Level 权重

等级	积分范围	权重
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

代码示例

Python

import requests

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

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

print(f"Earn Level: {data['level']} (weight={data['weight']})")
print(f"Quota share: {data['my_share_pct']} of platform weight {data['platform_total_effective_weight']}")
for p in data["products"]:
    capped = " (capped)" if p["concentration_cap_applied"] else ""
    print(f"  {p['product_name']}: quota today {p['quota_today']}{capped}")
print(f"Cross-product quota today: {data['cross_product_quota_today']}")