Boatrace Japan (Kyotei) — Race Cards, Results & Payouts

Structured, English-normalized data for Japanese boat racing (kyotei) — the official public-gambling sport with ~¥2.4 trillion in annual betting turnover, racing nearly 365 days a year across 24 stadiums. Data comes on demand from the official boatrace.jp public pages (no login, robots.txt allows crawling). One call per race returns:

• Race card — all 6 racers with class (A1/A2/B1/B2), branch, age/weight, false-start & late counts, average ST, national and local win rates, and motor & boat top-2/top-3 percentages (the stats every kyotei model is built on)
• Result (once the race has run) — finish order with race times, start timing (ST) per lane, the winning technique (kimarite: nige / sashi / makuri…), and every payout (trifecta, trio, exacta, quinella, wide) with popularity rank
• Race metadata — event title, race type, distance, stadium

Why this exists

The official site distributes data only as LZH-compressed, fixed-width, Shift-JIS text files — a real barrier if you are not on Windows or not Japanese-speaking. Community JSON mirrors cover results only, ~1 day late. This actor is the on-demand structured view: race-day cards and same-day results, in one call, in English field names. Nothing is stored between runs.

Built for betting-model developers, data scientists and analytics tools working on kyotei prediction — one of the most active machine-learning hobbyist scenes in Japan.

Pricing — from $0.02 per race, no subscription

Event	Price	When
Race summary (card + result + payouts)	$0.02	Per race analyzed
Individual racer entry	$0.002	Only if you enable Include individual entries

A default run (1 race) costs $0.02. You are never charged for a race that returns no data.

Input

Field	Example	Notes
date	"20260724"	Race day (YYYYMMDD). Past dates work
stadium	2	1=Kiryu … 2=Toda … 12=Suminoe … 24=Omura (full list in the field description)
races	[2]	Race numbers 1-12; empty = all 12
includeResult	true	Fetch result/payouts per race
includeIndividualEntries	false	Push each racer as a record

Output example (one race)

{
  "type": "race_summary",
  "date": "2026-07-24",
  "stadiumCode": 2,
  "stadiumName": "Toda",
  "raceNumber": 2,
  "eventTitle": "第10回週刊大衆杯",
  "distanceM": 1800,
  "status": "finished",
  "entries": [
    {"lane": 1, "racerId": 5033, "racerClass": "B1", "name": "藤原 孝斗", "branch": "愛知", "age": 28, "weightKg": 53.7,
     "fCount": 0, "lCount": 0, "avgST": 0.18,
     "national": {"winRate": 4.35, "top2Pct": 27.16, "top3Pct": 35.8},
     "local": {"winRate": 4.47, "top2Pct": 26.67, "top3Pct": 33.33},
     "motor": {"number": 17, "top2Pct": 30.99, "top3Pct": 53.05},
     "boat": {"number": 41, "top2Pct": 33.64, "top3Pct": 45.79}}
  ],
  "result": {
    "finish": [{"place": 1, "lane": 4, "racerId": 3745, "name": "橋本 年光", "raceTime": "1'50\"9"}],
    "startTiming": [{"lane": 1, "st": ".19"}, {"lane": 4, "st": ".17", "kimarite": "まくり"}],
    "kimarite": "まくり",
    "kimariteEn": "makuri (outside sweep)",
    "payouts": [
      {"betType": "trifecta", "combination": "4-2-6", "payoutJpy": 6250, "popularity": 26},
      {"betType": "trio", "combination": "2=4=6", "payoutJpy": 1920, "popularity": 8}
    ]
  }
}

Use cases

• Prediction models — pull cards (racer/motor/boat stats) before the race and results after, without parsing Shift-JIS fixed-width files
• Payout research — trifecta payout distributions per stadium/race-type in a few calls
• Dashboards & bots — same-day results with kimarite and ST, as JSON

Notes & limits

• If a race has not run yet, status is not_run_yet and result is null — the card is still returned and charged as one race
• Disqualifications (F/L/転/落…) appear verbatim in place for affected boats
• Read-only and throttled (~1 request / 1.5 s). No login, no personal data beyond the public racer register, nothing stored between runs

---

日本語ガイド

ボートレース公式サイトの出走表・結果・払戻を1コールで構造化JSONにして返す Actor です。

• 概要: レース単位で、出走表(6艇の級別・支部・F/L・平均ST・全国/当地勝率・モーター/ボート2連率3連率)と、レース確定後は着順・レースタイム・進入ST・決まり手・全払戻(人気順位付き)を英語フィールド名で返します。公式のデータ配布(LZH圧縮・Shift-JIS固定長)を扱う必要がありません。
• 使い方: date(YYYYMMDD)と stadium(1〜24: 2=戸田、12=住之江 など)を指定してください。races を空にすると当日12レース全部を取得します。
• 料金: レースサマリー1件 $0.02。個別選手レコードが必要な場合のみ includeIndividualEntries を ON(+$0.002/艇)。データが取れないレースには課金されません。サブスクリプション不要です。