Developer API
公開只讀 API
Pro 認證 · 天喜衍生數據 · 未鎖今日預測不開放
Authorization: Bearer tx_live_…；D1 只存 SHA-256。禁止無認證公開完整數據。內容僅供研究，唔構成投注建議。限額Limits
建議預設
- 每 key 每分鐘 < 60 次；超過回 429
- 每 key 每日 < 5000 次；超過回 429
- Pro 會籍過期 → 403 entitlement_expired
- 未凍結賽日嘅 picks／features → 403 not_frozen
端點Endpoints
v1
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /api/v1/elo/horses/:id?from=&to= | 馬匹 Elo 時間序列（天喜衍生） |
| GET | /api/v1/elo/snapshot?date= | 指定日期 Elo 快照（可限 scopes） |
| GET | /api/v1/picks/frozen?date= | 只回最終／已凍結四揀 |
| GET | /api/v1/picks/history?from=&to= | 凍結歷史＋命中摘要 |
| GET | /api/v1/features/:raceId | 只已排位／已鎖場次特徵（可選） |
curl 範例Example
curl -sS 'https://api.tianxi.racing/api/v1/picks/frozen?date=2026-10-25' \ -H 'Authorization: Bearer tx_live_YOUR_KEY'
Base URL 以實際 Worker 為準。金鑰喺 帳戶 → API 建立（Pro；明文只顯示一次）。
條款Terms
- 研究／非投注用途；唔提供落注或賠率套利服務。
- 只開放天喜衍生數據；馬會原始資料不作再分發。
- 研究層工具輸出唔入公開戰績；官方凍結四揀唔會經 API 被改寫。
- 濫用、轉售或嘗試繞過限額／認證可撤銷 key。