AstralX 排行榜 API 对接资料包 / Ranking API handoff
2026-11-05 | 中文 + English

1. 打开 01-API-handoff-zh-en.html 阅读完整说明；可使用页面的打印按钮保存为 PDF。
2. 02-ranking-snapshot-example.json 是单账户结构示例，不是真实成绩，也不是完整 20 人快照。
3. 本包说明的是当前网站约定及正式接入待办。AstralX 尚未提供正式数据接口；这里的 /api/rankings 是大赛网站的展示接口。

请 AstralX 技术与赛事运营团队确认：
- 测试及正式只读 API、鉴权、权限范围、技术联系人；
- 赛事 ID、账户 ID，以及本站报名记录与平台账号的归属核验和私有映射；
- 权威名次、净值、总收益率、品种盈亏、费用、同分和取消资格规则；
- 每 5 秒更新的可行性、数据时间、递增序号、延迟与限流；
- 上一完整统计日最终排名、品种盈亏、时区、结算边界和历史修订规则；
- 经同意公开的昵称、头像及社媒；AI 摘要另需真实交易记录、复核和授权。

English
1. Open 01-API-handoff-zh-en.html for the full bilingual brief. Use its Print button to save a PDF.
2. 02-ranking-snapshot-example.json shows one illustrative account, not real results or a full 20-account snapshot.
3. This pack describes the current website contract and production work still required. AstralX has not supplied a live feed. /api/rankings is the competition website's display endpoint.

AstralX engineering and competition operations should confirm:
- Read-only test/production APIs, authentication, scopes and technical contacts;
- Competition/account IDs, verified ownership and private mapping to website registrations;
- Official ranks, equity, total returns, instrument P&L, fees, ties and disqualification rules;
- Feasibility of 5-second updates, source timestamps, increasing sequences, latency and rate limits;
- Prior completed-day final ranks and instrument P&L, timezone, boundaries and historical revisions;
- Approved public aliases, avatars and social links. AI summaries additionally require actual trade records, review and consent.

在线说明 / Online brief:
https://forextradingcompetition.com/astralx-ranking-api-brief.html
排行榜演示 / Ranking demo:
https://forextradingcompetition.com/ranking?lang=zh
https://forextradingcompetition.com/ranking?lang=en
