RacingLLM B2B API 文檔 v4.3

所有 endpoint 返 JSON，認證用 Bearer token（API key）。數據覆蓋：30K+ 場本地賽事 + 海外轉播賽事（S1-S9）、1.16M 操練記錄、1,996 次試閘、673K+ 賠率數據。

海外賽事包含：HKJC 匯合彩池賠率（WIN/PLA/QIN/QPL）、Bookmaker 賠率（Bet365/Unibet 等）、AI 預測（Score% + PICK）。Venue code 用 S1, S2, S3... 格式。

Base URL: https://racingapi.scga.hk/v1

所有 B2B endpoint 需要 API key 作為 Bearer token：

curl -H "Authorization: Bearer <YOUR_API_KEY>" \
  https://racingapi.scga.hk/v1/b2b/races

API Key 等級

錯誤回應

{"detail": "Invalid or inactive API key"}

※ B2B API key 由管理員人手開通（聯絡 RacingLLM），唔設網上自助購買。

GET /v1/b2b/races/2026-06-10/HV/7

Business+ 額外有 sectionals；Enterprise 額外有 raw_model_scores。

{
  "race_date": "2026-06-10",
  "venue": "HV",
  "race_no": 7,
  "race_id": "2026-06-10-HV-7",
  "distance": 1650,
  "race_name": "會員盃",
  "race_class": "C3",
  "track": "TURF",
  "going": "GOOD",
  "num_horses": 12,
  "horses": [
    {
      "horse_no": 1,
      "horse_name_ch": "金鎗六十",
      "draw": 5,
      "rating": 110,
      "win_odds": 3.5,
      "win_prob": 0.25,
      "place_prob": 0.65,
      "top4_prob": 0.85
    }
  ],
  "top4_horses": [1, 3, 7, 5],
  "is_focus_race": true,
  "focus_banker": [
    {
      "horse_no": 3,
      "horse_name_ch": "重心馬",
      "win_odds": 8.4,
      "pred_odds": 8.1,
      "diff_pct": -3.6,
      "win_prob_model": 0.10,
      "heat_pct": 14.2,
      "whale_score": 858,
      "pace_class": 0,
      "pace_label": "快",
      "running_style": "frontMid",
      "style_label": "前領",
      "style_fit": false,
      "scope": "strict",
      "confidence": { "level": "medium", "label_ch": "中", "expected_top3_pct": 28 }
    }
  ],
  "focus_signals": {
    "banker_horse_no": 3,
    "band": "6-10",
    "heat_top3": [ { "horse_no": 3, "heat_pct": 14.2 }, { "horse_no": 1, "heat_pct": 12.1 }, { "horse_no": 5, "heat_pct": 9.8 } ],
    "model_top4": [ { "horse_no": 1, "win_prob_model": 0.19 }, { "horse_no": 3, "win_prob_model": 0.10 } ],
    "adj4": [ { "horse_no": 1 }, { "horse_no": 3 }, { "horse_no": 7 } ],
    "consensus": [ { "horse_no": 3, "heat_pct": 14.2 } ],
    "heat_rank": [ { "horse_no": 3, "heat_pct": 14.2 }, { "horse_no": 1, "heat_pct": 12.1 } ]
  },
  "focus_bets": {
    "banker": 3,
    "banker_name": "重心馬",
    "banker_odds": 8.4,
    "band": "6-10",
    "quinella": {
      "label": "連贏 重心馬＋fit頭1腳", "stake_note": "1 注",
      "banker": 3, "legs": [1], "combos_n": 1, "odds_available": true,
      "combos": [ { "combo": "3-1", "legs": [3, 1], "odds": 12.0 } ]
    },
    "qpl": {
      "label": "位置Q 重心馬＋fit頭1腳", "stake_note": "1 注",
      "banker": 3, "horses": [3, 1], "legs": [1], "combos_n": 1, "odds_available": true,
      "combos": [ { "combo": "3-1", "legs": [3, 1], "odds": 5.0 } ]
    },
    "forecast": {
      "label": "二重彩 複式（重心馬＋fit頭1腳）", "stake_note": "2 注",
      "banker": 3, "legs": [1], "combos_n": 2, "odds_available": false,
      "combos": [
        { "combo": "3>1", "order": [3, 1], "odds": null }, { "combo": "1>3", "order": [1, 3], "odds": null }
      ]
    },
    "win": {
      "label": "獨贏 重心馬", "stake_note": "1 注",
      "banker": 3, "combos_n": 1, "odds_available": true,
      "combos": [ { "combo": "#3", "legs": [3], "odds": 8.4 } ]
    },
    "trio": {
      "label": "單T 一膽拖三腳", "stake_note": "3 注",
      "banker": 3, "legs": [1, 5, 7], "legs_source": "fit",
      "qualified": true, "filter": { "hot_model5": 4, "late7_hot5": 4 },
      "combos_n": 3, "odds_available": false,
      "combos": [
        { "combo": "1,3,5", "odds": null }, { "combo": "1,3,7", "odds": null }, { "combo": "3,5,7", "odds": null }
      ]
    },
    "tierce": {
      "label": "三重彩 一膽拖三腳", "stake_note": "18 注",
      "banker": 3, "legs": [1, 5, 7], "legs_source": "fit",
      "qualified": true, "filter": { "hot_model5": 4, "late7_hot5": 4 },
      "combos_n": 18, "odds_available": false,
      "combos": [
        { "combo": "1,3,5", "odds": null }, { "combo": "1,5,3", "odds": null }, { "combo": "3,1,5", "odds": null }
      ]
    },
    "first4": {
      "label": "四連環 兩膽拖四腳", "stake_note": "6 注",
      "banker": 3, "banker2": 1, "bankers": [3, 1], "legs": [5, 7, 2, 8], "legs_source": "model",
      "combos_n": 6, "odds_available": false,
      "combos": [
        { "combo": "1,2,3,5", "odds": null }, { "combo": "1,2,3,7", "odds": null }
      ],
      "note": null
    }
  },
  "cold_horses": [
    { "horse_no": 8, "horse_name_ch": "精選配腳A", "tag": "精選配腳", "win_odds": 12.0 },
    { "horse_no": 12, "horse_name_ch": "精選配腳B", "tag": "精選配腳", "win_odds": 15.0 },
    { "horse_no": 2, "horse_name_ch": "冷門馬", "tag": "冷門", "win_odds": 35.0 }
  ],
  "dark_horses": [
    { "horse_no": 2, "horse_name_ch": "冷門馬", "tag": "冷門", "win_odds": 35.0, "residual": 0.012 }
  ],
  "confidence": { "level": "⭐⭐⭐", "score": 85, "signals": { "#1_odds": 2.3, "#2_odds": 4.1, "score_gap": 0.067 } },
  "hit_rates": { "win_hit": true, "place_hit": true, "top4_hit_count": 3 },
  "focus_hits": { "qin": { "hit": true, "div": 78.5, "stake": 10 }, "qpl": { "hit": true, "hits": 1, "div": 24.5, "stake": 10 }, "fct": { "hit": false, "div": null, "stake": 20 } }
}

※ v3.2: cold_horses 分 精選配腳 (Model #5-6) 同 冷門 (residual picks)，用 tag 區分。confidence 改用 level (⭐⭐⭐/⭐⭐/⭐) + signals (#1_odds/#2_odds)。

※ §90.124（2026-10-08）：舊 tier「投注策略」（betting_recommendation / betting_hits，G4/G5 分歧場限定 WIN/F4/TRIO/TCE）已全面退役，一律唔再輸出（回 null）。取而代之 = focus_banker / focus_signals / focus_bets（重心馬 7 瓣：獨贏／連贏／位置Q／二重彩／單T／三重彩／四連環）＋ focus_hits（逐場賽後命中＋真 HKJC 派彩）。

※ §90.122：連贏／位置Q／二重彩 三瓣統一 = 「重心馬 ＋ fit 頭1腳」同一對馬（連贏 1 注、位置Q 1 注、二重彩複式 2 注／$20）。

※ v3.6（breaking）：place_prob / top4_prob 而家出 模型原本機率（raw、pre-heat）。raw 永遠 < 1（約 0.88 以下），所以正常唔會出「100%」。heat-adjusted 版純粹內部用嚟排序，唔會出街（已移除 *_prob_heat）。win_prob 不變。

GET /v1/b2b/races/2026-07-28/S1/1

海外 venue code 用 S1-S9 格式，包含 HKJC 匯合彩池、Bookmaker 賠率、AI 預測（Score%）。

{
  "race_date": "2026-07-28",
  "venue": "S1",
  "race_no": 1,
  "race_id": "2026-07-28-S1-1",
  "is_overseas": true,
  "country": "英國",
  "course": "古活馬場",
  "post_time": "2026-07-28T20:50:00+08:00",
  "distance": 1985,
  "track": "草地",
  "going": "好地",
  "num_horses": 17,
  "runners": [
    { "horse_no": 1, "horse_name_ch": "任意行", "win_odds": 13.0,
      "jockey_name_ch": "李奇豐", "trainer_name_ch": "伯特",
      "last6run": "5/8/4/5/1" },
    { "horse_no": 7, "horse_name_ch": "迪哥芝味", "win_odds": 5.8, ... }
  ],
  "hkjc_odds": [
    { "pool_type": "WIN", "comb_string": "07", "horse_name_ch": "迪哥芝味", "odds_value": 5.8 },
    { "pool_type": "PLA", "comb_string": "07", "odds_value": 1.7 },
    { "pool_type": "QIN", "comb_string": "07,14", "odds_value": 42.0 },
    { "pool_type": "QPL", "comb_string": "07,14", "odds_value": 19.0 }
  ],
  "bookmaker_odds": [
    { "horse_name_en": "Diego El Queso (IRE)", "best_decimal_odds": 5.5 },
    { "horse_name_en": "Al Aali (FR)", "best_decimal_odds": 7.5 }
  ],
  "predictions": [
    { "horse_no": 7, "name_ch": "迪哥芝味", "prob": 0.425, "pick": true },
    { "horse_no": 14, "name_ch": "皇屬晴空", "prob": 0.421, "pick": true },
    { "horse_no": 16, "name_ch": "超頂級", "prob": 0.418, "pick": true }
  ]
}

※ runners 已過濾退出馬（Scratched）；hkjc_odds 包含 WIN/PLA/QIN/QPL 四種彩池；predictions 按 Score% 高至低排序，Top 3 標記為 PICK。

Webhook 讓你嘅程式喺數據變動時實時收到推送通知。限 Business / Enterprise 等級。

事件類型

註冊 Webhook

POST /v1/b2b/webhooks

curl -X POST -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-server.com/hook","events":["results.updated"],"secret":"your-secret"}' \
  https://racingapi.scga.hk/v1/b2b/webhooks

簽名驗證（Python）

import hashlib, hmac

def verify(body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

Python

import requests

BASE = "https://racingapi.scga.hk/v1"
HEADERS = {"Authorization": "Bearer <YOUR_API_KEY>"}

# 搜尋馬匹
r = requests.get(f"{BASE}/b2b/horses/search", params={"q": "金"}, headers=HEADERS)
print(r.json())

# 賽事詳情（Business+ 有對陣矩陣）
r = requests.get(f"{BASE}/b2b/races/2026-07-08/HV/1", headers=HEADERS)
race = r.json()
print(f"Top 4: {race['top4_horses']}")

cURL

# 列出日期賽事
curl -H "Authorization: Bearer <YOUR_API_KEY>" \
  https://racingapi.scga.hk/v1/b2b/races/2026-07-08

# 分段時間分析（Business+）
curl -H "Authorization: Bearer <YOUR_API_KEY>" \
  "https://racingapi.scga.hk/v1/b2b/analysis/sectionals?date=2026-07-08&venue=HV&race_no=1"

# 提交 B2B 查詢（免認證）
curl -X POST -H "Content-Type: application/json" \
  -d '{"name":"John","email":"[email protected]","message":"想了解 Enterprise"}' \
  https://racingapi.scga.hk/v1/b2b/inquiry

預測欄位

場地代碼

所有 B2B 回應都包含限額資訊標頭：

X-RateLimit-Minute-Remaining: 29
X-RateLimit-Month-Remaining: 9847
X-RateLimit-Month-Overage: 0

v4.4 (2026-10-08，breaking) — 舊 tier「投注策略」全面退役（§90.124）：betting_recommendation / betting_hits / betting_date_stats 一律回 null（唔再輸出）；/v1/stats、/v1/stats/betting、/v1/season-history、/v1/b2b/stats/{season} 嘅 pools 變空（只剩 model_stats）。取而代之 = 重心馬 focus_bets（7 瓣）＋ focus_hits；季節 ROI 睇 /v1/stats/focus-roi；/v1/strategy/bets 改由 focus_bets 出。舊 client 若讀 tier 策略欄位要改。

v4.3 (2026-10-09) — focus_bets 由 3 瓣擴到 7 瓣：新增 win（獨贏重心馬）、trio（單T 一膽拖三腳，腳=模型頭3）、tierce（三重彩一膽拖三腳，有序）、first4（四連環兩膽拖四腳，第二膽=絕對第2熱）。trio/tierce 帶 qualified＋filter（兩重過濾「熱∩模5≥4 且 末段頭7∩熱度頭5≥3」，成本貴所以嚴格先落）。新增逐場賽後命中欄位 focus_hits（7 瓣 {hit, div, stake}，只喺單場詳情 endpoint）。⚠️ 舊場嘅凍結 focus_bets 只有 3 瓣，已 backfill 補齊。純新增、向後兼容（原有 3 瓣 key 完全不變，數字亦不變）。

v4.2 (2026-10-09，breaking) — focus_banker 口徑改為「三重合體」（熱度頭3 ∩ 四選 ∩ 末段ADJ4）中獨贏賠率落 6–10 帶、熱度最高嗰隻，唔再靠步速／重心場。新增 focus_signals（三組原始訊號：heat_top3 / model_top4 / adj4 / consensus）同 focus_bets（重心馬投注方法：連贏一膽拖三腳 + 位置Q 三隻 Box + 二重彩複式馬膽，逐注組合賠率）。移除 fav_no/fav_odds/fav_style/place_prob（改出 heat_pct/whale_score）。⚠️ 二重彩冇「即時賠率」數據源 → forecast.combos[].odds 永遠 null；但 賽後派彩已補齊（HKJC 結果頁本身有二重彩彩池，v4.2 起 scrape 入 race_dividends pool='FCT' 有序對）→ /v1/b2b/results/... 嘅 dividends.FCT（key 例 "7>9"）。口徑見「重心馬（做膽用）」同「重心馬投注方法（focus_bets）」兩節。舊 client 若靠 v4.1 次熱口徑要調整。

v4.1 (2026-10-03，breaking) — focus_banker 口徑改為「重心場（大熱跑法唔配合預測步速）內嘅次熱（賠率第 2 低）」，取代舊「正數表」（win≥5%＋差%>0＋四選以外＋預 7–15）。scope="top4" 停用（array 而家最多一隻，一定 strict）。新增純顯示欄位 pace_class/pace_label（＋原有 running_style/style_label/style_fit、fav_*），唔影響揀膽。is_focus_race 亦改為「大熱跑法唔配合步速」判定，唔再由重心馬推導。舊 client 若靠 scope="top4" 要調整。

v4.0 (2026-09-30，breaking) — focus_banker 由 object 改為 array（最多兩隻，靠 scope 分辨口徑：strict＝四選以外做膽、一定喺 [0]；top4＝寬口徑∩四選）。舊 B2C-only 嘅 focus_banker_top4 併入 array，唔再另出。所有回 focus_banker 嘅 endpoint 一致。舊 client 讀 focus_banker.horse_no 要改 focus_banker[0].horse_no。

v3.11 (2026-09-30) — focus_banker 新增 confidence（信心程度）：由該隻馬自己嘅 win_prob_model 分段（normal/medium/high + label_ch + expected_top3_pct），唔用 place/top4 機率衍生。出現喺所有回 focus_banker 嘅 endpoint（/v1/b2b/races/...、/v1/b2b/results/...）。189 場 walkforward 實測支撐。口徑見「重心馬（做膽用）」一節。純新增、向後兼容。

v3.10 (2026-09-28) — 新增 focus_banker（重心馬／做膽用）：出現喺 /v1/b2b/races/{date}、/v1/b2b/races/{date}/{venue}/{race_no} 同 /v1/b2b/results/...（prediction_snapshot.focus_banker，賽前凍結判斷）。同日新增 is_focus_race（★ 焦點場）— 只喺日期列表 endpoint（/v1/b2b/races/{date}），單場詳情唔會回。同時補回一直漏咗嘅 /v1/b2b/results 兩個 endpoint 入文檔。口徑見「重心馬（做膽用）」一節。純新增、向後兼容。

v3.9 (2026-09-26) — 所有 race 相關 endpoint（/v1/b2b/races/{date}、/v1/b2b/races/{date}/{venue}/{race_no}、/v1/b2b/predictions/latest、/v1/b2b/results/...）新增 race_id 欄位（格式 {race_date}-{venue}-{race_no}，例：2026-09-26-ST-9）。純新增、向後兼容 —— venue / race_no 完全不變。原因：日期列表同最新預測係扁平 array（本地 + S1-S9 海外混埋），海外 race_no 由 1 重數會同本地撞；race_id 係全站唯一，請用它做 key / join。

v3.8 (2026-08-09) — 投注策略升級為 G5 靈活：分歧場限定（model #1 ≠ 市場大熱）、2馬膽拖5腳 F4 $100 + 複式單T 4選 $40 + WIN（冇 gate）$10，每分歧場合計 $150。所有季績均改為 walk-forward 回測（真實 HKJC 派彩、組合式 ROI 數學）；/v1/b2b/stats/{season} 只開放近 5 季（2021-22 → 2025-26），更早嘅 10 季回測為內部資料；公眾 /v1/stats/betting 只開放近 3 季。

v3.7 (2026-08-08) — 投注策略升級為 G4 全Model：馬膽 = model #1（純 model win_prob），配腳 = 純 model，唔再混市場賠率（舊 blend 腳退役）；ranking / top4 / 馬膽 / 配腳 一律全Model。3季 walkforward 實測（真實 HKJC 派彩，F4+單T 分歧核心 $160/場）合計 +49.0% ROI（2023-24 +77.7% / 2024-25 +31.2% / 2025-26 +36.1%，1,444 場）；WIN $10 value-gated side-bet 另列。

v3.6 (2026-08-07) — 投注策略升級為 G4 靈活：分歧場限定（model #1 ≠ 市場大熱）、冇分級門檻，F4 一膽拖5 blend腳 $100 + 單T 一膽拖4 blend腳 $60 + WIN(value) $10，每分歧場合計 $170。3季 walkforward 實測（真實 HKJC 派彩）合計 +20.1% ROI（2023-24 +25.5% / 2024-25 +32.1% / 2025-26 +4.4%），每季正回報。

v3.5 (2026-08-05) — /v1/stats 及 /v1/b2b/stats/{season} 改為即時計算（唔再讀舊 snapshot），返回 model_stats（全季命中率）+ pools（G4 投注 ROI，真實 HKJC 派彩、flexi-bet 單位正確）；betting_recommendation.strategy 加入 name + tier。

v3.2 (2026-08-01) — XGBoost 模型上線：95 項基礎數據預測；精選配腳（Model #5-6）+ 冷門（residual）分開顯示，用 tag 區分；confidence 改用 level (⭐⭐⭐/⭐⭐/⭐) + signals (#1_odds/#2_odds)；新增 betting_recommendation（獨贏·四連環·單T）、betting_hits（命中+真實HKJC派彩）、betting_date_stats（是日投注回報）；flop_analysis 已移除；cold_horses 格式更新。

v3.1 (2026-07-28) — 海外賽事支援：S1-S9 venue code 可用於所有 race endpoint；返回 HKJC 匯合彩池賠率（WIN/PLA/QIN/QPL）、Bookmaker 賠率（Bet365/Unibet）、AI 預測（Score% + PICK）；`has_overseas` flag on date list；`is_overseas` flag on race detail；model_rankings（M1-M4）in response。

v3.0 (2026-07-09) — 12 個新 B2B endpoint：馬匹搜尋/資料/賽績/操練/試閘、騎師練馬師搜尋/詳細、賠率時序/批次、分段分析；Business+ 有 QIN/QPL 對陣矩陣、Enterprise 有原始模型評分；Webhook 系統（HMAC-SHA256）；分級數據開放。

v2.0 (2026-06-11) — 首個 B2B API 版本，三級制 Pro / Business / Enterprise。