記事 / 情報

JRA公式データ(JV-Link)とは何か — 競馬AIは何を見ているのか

JRA-VAN が提供する JV-Link と JV-Data の役割、どんなレコードがいつ届くのか、スクレイピングとの違い、締切前に確定する情報と確定しない情報の線引きを説明します。Tippa の AI が使う入力の出どころを公開する記事です。

競馬 AI の予想の質は、アルゴリズムより先に「どのデータを、いつ、どの経路で受け取ったか」で決まります。Tippa の AI が入力にしているのは、JRA の公式データ配信サービスである JRA-VAN Data Lab. から、JV-Link という仕組みで取り込んだ JV-Data です。この記事では、その中身と限界を説明します。

JV-Link と JV-Data の関係

JV-Data は、JRA が公式に配信する競馬データの総称です。レース詳細、出走馬ごとの成績、オッズ、払戻、馬・騎手・調教師のマスタなどが、レコード種別ごとに固定長のテキストとして提供されます。JV-Link は、そのデータをサーバーから受け取って自分のプログラムに渡すための接続部品(Windows 用の COM コンポーネント)で、JRA-VAN Data Lab. の会員向けに提供されています。

プログラムは JV-Link に「このデータ種別を、この時刻以降の分だけ」と指定して取得を開いてから、レコードを 1 件ずつ読み出します。取得した最後のファイルの時刻を控えておき、次回はその時刻から続きを取る、という運用が仕様で想定されています。

種別内容確定する時期
RA(レース詳細)開催日、競馬場、距離、コース、馬場、クラス、グレード出走表確定時、天候・馬場は当日更新
SE(馬毎レース情報)枠番、馬番、斤量、馬体重、騎手、そして着順・通過順位・上がり出馬表段階で枠番・馬番・斤量・騎手、着順・通過順位・上がりはレース後。当日の馬体重は別の WH レコード
O1(単勝・複勝オッズ)時点ごとのオッズと人気順発売中は変動、確定オッズはレース後
HR(払戻)券種ごとの払戻金レース確定後
UM / KS / CH(マスタ)馬・騎手・調教師の基本情報登録・変更時
Tippa が使う主なレコード種別と、確定する時期

同じ SE レコードでも、締切前と後で中身が違う

JV-Data のレコードには「データ区分」という値があり、同じ出走馬の情報でも、出馬表の段階と、レース後の速報成績・確定成績で区分が変わります。着順、通過順位、上がり 3 ハロンといった項目は、レース後の区分でしか意味のある値が入りません。当日発表の馬体重は SE ではなく別の WH(馬体重)レコードで届きます。締切前に予想を作るプログラムは、この区分を見て「今は入っていない項目」を扱う必要があります。

スクレイピングと公式データの違い

  • 出どころ: 公式データは JRA の配信、スクレイピングは第三者サイトの表示。表示の遅延・修正・欠落の影響を受ける。
  • 時刻の扱い: 公式データはファイルのタイムスタンプで「いつ時点の値か」が付いてくる。表示を拾う方法では取得時刻しか分からない。
  • 規約: 公式データは JRA-VAN の利用規約の範囲で使う。サイトの表示を機械的に取る方法は、サイト側の規約に反することが多い。
  • 運用: 公式データは Windows 上の JV-Link が必要で、取得する PC が動いていないと届かない。

Tippa が公式データを選んでいる理由は、規約の面に加えて、「いつ時点の値か」を記録に残せる点にあります。締切前の提出を後から検証するには、入力データの時刻が確かでなければなりません。

取得が止まると何が起きるか

公式データの取得は、JV-Link を動かす Windows PC が稼働している間しか進みません。取得が締切に間に合わなければ、AI は予想を提出せず、その事実が記録に残ります。無理に古いデータで提出するより、提出しない方が成績の信頼性を保てるためです。

実データ例: 人気信者 AI の精算済み成績

人気信者

締切前の公式データの人気順どおりに買うだけの、もっとも単純なルール型 AI です。公式データが締切前に取得できた日の提出だけが精算対象になります。

集計対象なし — 公式結果で精算済みの提出予想がまだありません。件数が積み上がり次第、この欄に数値が入ります。