# JVOpen("RACE") で払戻データ（HR）が取得できず、JG / H1 が返る件について

**URL:** <https://developer.jra-van.jp/t/topic/860>\
**Category:** JV-Link（API）\
**Tags:** question, jv-link\
**Created:** [2026 年 6 月 10 日午前 7:44 UTC](https://developer.jra-van.jp/t/topic/860 "2026-06-10T07:44:17Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![e2313030](https://avatars.discourse-cdn.com/v4/letter/e/c67d28/32.png) [@e2313030](https://developer.jra-van.jp/u/e2313030)\
**Post date:** [2026 年 6 月 10 日午前 7:44 UTC](https://developer.jra-van.jp/t/topic/860/1 "2026-06-10T07:44:17Z")

</div>

JV-Link で払戻データ（HRレコード）を取得したく、取得条件について質問です。

【やりたいこと】  
過去のレース払戻データ（HR）を取得したいです。  
`JVOpen("RACE", fromtime, option, 0, 0, "")` を使って確認しています。

【環境】

- Windows

- Python 32bit から `JVDTLab.JVLink` を呼び出し

- `JVInit()` は 0 で成功

- `JVOpen()` / `JVRead()` / `JVClose()` は実行できています

【確認した結果】

1. `198601` を対象にした場合

- option 1 → JG

- option 2 → JG

- option 3 → H1

- option 4 → H1

- HR は返りませんでした

1. `202505`〜`202604` を月単位で確認した場合

- option 1 は主に JG、一部月で H1

- option 2 は JG

- option 3 / 4 は H1

- HR は確認できませんでした

1. 日付単位でも確認しました  
手元にあるHRデータの日付前後を、option 1〜4 で日付単位に確認しましたが、追加でHRが返る組み合わせは見つかりませんでした。

2. `JVStatus()` も確認しました  
`JVOpen("RACE", "20250501000000", 1, 0, 0, "")` 実行後、`JVStatus` は `0 → 19 → 25` と遷移し、その後 `25` で安定しました。  
その状態で `JVRead()` を行うと `-3` にはならず、すぐに `JG` レコードが返り始めました。

【補足】  
手元には `HR` 形式の `hr_raw.csv` があり、以下の内容でした。

- レコード数: 527

- 日付範囲: 2025/05/31 ～ 2025/07/20

- 16開催日分

- 先頭レコードは `HR...` 形式

ただし、現在はこちらと同じようなHR取得結果を再現できていません。

【質問】

1. `JVOpen("RACE", ...)` で `HR` ではなく `JG` / `H1` が返るのは仕様でしょうか。

2. 払戻データとして `HR` を取得したい場合、正しい `dataSpec` / `option` / `fromtime` の指定方法はありますか。

3. `HR` が返らない場合、払戻データとしては `H1` を参照するのが正しいのでしょうか。

取得条件や仕様上の考え方をご教示いただけますと助かります。  
よろしくお願いいたします。

---

<div class="post-metadata">

**Author:** ![takeshi](https://yyz1.discourse-cdn.com/flex029/user_avatar/developer.jra-van.jp/takeshi/32/735_2.png) [@takeshi](https://developer.jra-van.jp/u/takeshi)\
**Post date:** [2026 年 6 月 10 日午後 12:48 UTC](https://developer.jra-van.jp/t/topic/860/2 "2026-06-10T12:48:06Z")

</div>

> [@e2313030](#):
>
> `JVOpen("RACE", ...)` で `HR` ではなく `JG` / `H1` が返るのは仕様でしょうか。

仕様です。dataSpec に RACE を指定した場合、RA / SE / HR / H1 / H6 / O1 / O2 / O3 / O4 / O5 / O6 / WF / JG などのレコードが返されます。

> [@e2313030](#):
>
> 払戻データとして `HR` を取得したい場合、正しい `dataSpec` / `option` / `fromtime` の指定方法はありますか。

各ファイルに含まれる recordSpec はあらかじめ決まっています。取得したレコードのうち不要なものについては、JVSkip() で読み飛ばすのが基本的な使い方になります。

> [@e2313030](#):
>
> `HR` が返らない場合、払戻データとしては `H1` を参照するのが正しいのでしょうか。

いいえ。H1 は「票数１」であり、三連単を除く各式別の確定票数が格納されているレコードです。払戻情報は含まれていませんので、払戻データとして参照するものではありません。

一度、開発ドキュメントを通読されることをおすすめします。JV-Link は20年以上前から提供されているシステムであり、最近のAPIやライブラリとは設計思想がかなり異なります。そのため、まず全体像を把握しておくと理解しやすいと思います。

> [@ソフトウェア開発キット（SDK）](https://developer.jra-van.jp/t/topic/45):
>
> ソフトウェア開発キット（SDK） JRA-VAN Data Lab.対応ソフトを開発する際に必要になる「ソフトウェア開発キット（SDK）」(Software Development Kit)を提供します。 [JRA-VAN SDK本体 （Ver.4.9.0.2）](https://jra-van.jp/dlb/sdv/sdk/JVDTLABSDK4902.zip)（2024/8/7） JV-Link ・・・サーバ通信モジュール JV-Data構造体 （C#版、C++版、Delphi7版、VB20…