Skip to main content
GET
/
races
レース一覧
curl --request GET \
  --url https://api.beter-keiba.com/v1/races \
  --header 'Authorization: Bearer <token>'
{
  "code": "SUCCESS",
  "data": [
    {
      "id": "ra_2024052605021211",
      "dataType": "2",
      "raceYear": 2024,
      "raceDate": "0526",
      "courseCode": "05",
      "raceNumber": 11,
      "title": "東京優駿",
      "distance": 2400,
      "dataUpdatedAt": 1716715200,
      "nTime": 2,
      "nDay": 12,
      "dayOfWeekCode": "1",
      "specialRaceNumber": "0000",
      "subTitle": "（日本ダービー）",
      "titleAppendix": "（ＧＩ）",
      "titleEnglish": "TOKYO YUSHUN",
      "titleShort10": "日本ダービー",
      "titleShort6": "ダービー",
      "titleShort3": "ダービー",
      "gradeCode": "A",
      "gradeChangedFrom": "A",
      "gradeCount": 91,
      "typeCode": "14",
      "signCode": "A41",
      "weightTypeCode": "4",
      "condition2Yo": "000",
      "condition3Yo": "001",
      "condition4Yo": "000",
      "condition5YoUp": "000",
      "conditionYoungest": "001",
      "conditionName": null,
      "distanceChangedFrom": 0,
      "trackCode": "17",
      "trackChangedFrom": "17",
      "courseSubset": "A",
      "prizes": [
        300000000,
        120000000,
        75000000,
        45000000,
        30000000
      ],
      "addedPrizes": [
        45122000,
        12892000,
        6446000
      ],
      "postTime": "1540",
      "postTimeChangedFrom": "1540",
      "entryCount": 18,
      "starterCount": 18,
      "finisherCount": 18,
      "weatherCode": "1",
      "turfConditionCode": "1",
      "dirtConditionCode": "1",
      "lapTimes": [
        12.2,
        10.8,
        11.3,
        12.1,
        12.6,
        12.7,
        12.5,
        11.7,
        11.3,
        11.1,
        11.2,
        11.5
      ],
      "steepleMileTime": null,
      "first3FTime": 34.3,
      "first4FTime": 46.4,
      "last3FTime": 33.8,
      "last4FTime": 45,
      "cornerPassingOrder": [
        {
          "corner": 1,
          "order": "15-2,5(3,7,12)(1,8,11,14)(4,13,17)-6,16,18-9-10"
        }
      ],
      "isRecordBreak": 0,
      "payout": {
        "raceId": "ra_2024052605021211",
        "dataType": "2",
        "entryCount": 18,
        "starterCount": 18,
        "flags": {
          "failed": {},
          "special": {},
          "refund": {}
        },
        "refundHorseNumbers": [],
        "refundBracketNumbers": [],
        "refundSameBracketNumbers": [],
        "win": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "place": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "bracketQuinella": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "quinella": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "wide": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "exacta": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "trio": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "trifecta": [
          {
            "numbers": "5",
            "payout": 4660,
            "popularity": 9
          }
        ],
        "createdAt": 1716716000,
        "updatedAt": 1716716000
      },
      "createdAt": 1716716000,
      "updatedAt": 1716716000
    }
  ],
  "extensions": {
    "totalCount": 150,
    "limit": 50,
    "page": 1,
    "totalPages": 3,
    "dataUpdatedAt": 1716715200
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.beter-keiba.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

APIダッシュボードで発行された sk_live_... キーを入力してください。

Query Parameters

​
accessKey
string
required

APIアクセスキー (bk_live_...)

​
date
string<date>

指定した日で絞り込み

​
from
string<date>

期間指定（開始）

​
to
string<date>

期間指定（終了）

​
courseCode
enum<string>

競馬場および国コード。JRA、地方競馬(NAR)、海外を網羅します。

主要なコード一覧

コード競馬場・国名略称英語
01札幌競馬場札幌SAPPORO
02函館競馬場函館HAKODATE
03福島競馬場福島FUKUSHIMA
04新潟競馬場新潟NIIGATA
05東京競馬場東京TOKYO
06中山競馬場中山NAKAYAMA
07中京競馬場中京CHUKYO
08京都競馬場京都KYOTO
09阪神競馬場阪神HANSHIN
10小倉競馬場小倉KOKURA
30〜57地方競馬場--
58〜61地方競馬場（中央併設）--
A0〜N6海外の国・地域--

海外主要国例:

  • A2: 日本 (Japan)
  • A4: アメリカ (USA)
  • A6: イギリス (GB)
  • A8: フランス (FR)
  • G0: 香港 (HK)
  • C7: UAE (UAE)

※全コードの詳細はJV-Data仕様に準拠します。未設定時は 00 が返ります。

Available options:
00,
01,
02,
03,
04,
05,
06,
07,
08,
09,
10,
30,
31,
32,
33,
34,
35,
36,
37,
38,
39,
40,
41,
42,
43,
44,
45,
46,
47,
48,
49,
50,
51,
52,
53,
54,
55,
56,
57,
58,
59,
60,
61,
A0,
A2,
A4,
A6,
A8,
B0,
B2,
B4,
B6,
B8,
C0,
C2,
C5,
C6,
C7,
C8,
D0,
D2,
D4,
D6,
D8,
E0,
E2,
E4,
E6,
E8,
F0,
F1,
F2,
F8,
G0,
G2,
H0,
H2,
H4,
H6,
H8,
I0,
I2,
I4,
I6,
I8,
J0,
J2,
J4,
J6,
J8,
K0,
K2,
K4,
K6,
K8,
L0,
L2,
L4,
L6,
L8,
M0,
M2,
M4,
M6,
M8,
N0,
N2,
N4,
N6
Example:

"05"

​
gradeCode
enum<string>

競走のグレードを表すコード。

コード内容欧字表記
AG1（平地）G1
BG2（平地）G2
CG3（平地）G3
Dグレードのない重賞-
E重賞以外の特別競走-
FJ・G1（障害）J・G1
GJ・G2（障害）J・G2
HJ・G3（障害）J・G3
LL（リステッド）L
_一般競走 または 未設定-

※ _ は半角スペース(0x20)をアンダースコアに置換しています。

Available options:
A,
B,
C,
D,
E,
F,
G,
H,
L,
_
Example:

"A"

​
typeCode
enum<string>

競走の年齢・品種種別を表すコード。

コード名称略称(6文字)欧字名
11サラ系2歳サラ系2歳TWO-YEAR-OLDS
12サラ系3歳サラ系3歳THREE-YEAR-OLDS
13サラ系3歳以上サラ系3歳上THREE-YEAR-OLDS & UP
14サラ系4歳以上サラ系4歳上FOUR-YEAR-OLDS & UP
18サラ系障害3歳以上障害3歳上THREE-YEAR-OLDS & UP STEEPLE-CHASE
19サラ系障害4歳以上障害4歳上FOUR-YEAR-OLDS & UP STEEPLE-CHASE
21アラブ系2歳アラ系2歳-
22アラブ系3歳アラ系3歳-
23アラブ系3歳以上アラ系3歳上-
24アラブ系4歳以上アラ系4歳上-
00未設定未設定-

※2000年以前のデータは「数え年」表記のため、上記名称より年齢が1つ上がります（例: 11はサラ系3歳）。

Available options:
11,
12,
13,
14,
18,
19,
21,
22,
23,
24,
00
Example:

"14"

​
signCode
enum<string>

競走の条件（産地・性別・交流制限など）を表す3バイトのコード。JV-Data 仕様書「2006.競走記号コード」に準拠。

コードの構成

このコードは3バイトで構成され、各バイトが独立した属性を表します。

バイト属性値の範囲
第1バイト産地・購買条件等0 (下記以外) / A (混合) / B (父) / C (市) / D (抽) / E ([抽]) / F ((市)(抽)) / G ((抽) 関西配布馬) / H ((抽) 関東配布馬) / I ([抽] 関西配布馬) / J ([抽] 関東配布馬) / K ((市)(抽) 関西配布馬) / L ((市)(抽) 関東配布馬) / M (九州産馬) / N ((国際))
第2バイト性別制限0 (制限なし) / 1 (牡) / 2 (牝) / 3 (牡・ｾﾝ) / 4 (牡・牝)
第3バイト交流競走関係等0 (下記以外) / 1 ((指定)) / 2 (見習騎手・若手騎手) / 3 ([指定]) / 4 ((特指))

主要な記号の意味

記号内容
(混合)内国産馬に外国産馬が混合して出走できる競走
(国際)内国産馬に外国産馬および海外出走歴のある馬が混合して出走できる競走
(指定)JRA指定の地方競馬所属馬が出走可能
[指定]地方競馬所属の騎手が騎乗可能
(特指)地方競馬の認定競走勝ち馬が出走可能
(抽)JRA が市場で購買し抽選で馬主に配布したサラブレッド系内国産馬

代表的なコード例

コード内容
000制限なし (一般)
020牝
040牡・牝
A00(混合)
A40(混合) 牡・牝
A41(混合) 牡・牝 (指定)
N00(国際)
N01(国際) (指定)
N44(国際) 牡・牝 (特指)

※未設定時は 000 が返ります。

Available options:
000,
001,
002,
003,
004,
020,
021,
023,
024,
030,
031,
033,
034,
040,
041,
043,
044,
A00,
A01,
A02,
A03,
A04,
A10,
A11,
A13,
A14,
A20,
A21,
A23,
A24,
A30,
A31,
A33,
A34,
A40,
A41,
B00,
B01,
B03,
B04,
C00,
C01,
C03,
C04,
D00,
D01,
D03,
E00,
E01,
E03,
F00,
F01,
F03,
F04,
G00,
G01,
G03,
H00,
H01,
I00,
I01,
I03,
J00,
J01,
K00,
K01,
K03,
L00,
L01,
L03,
M00,
M01,
M03,
M04,
N00,
N01,
N03,
N04,
N20,
N21,
N23,
N24,
N30,
N31,
N40,
N41,
N44
Example:

"A41"

​
trackCode
enum<string>

コースの種類と形状を表すコード。

分類ガイド

  • 10番台: 芝 (Turf)
  • 20番台: ダート (Dirt)
  • 50番台: サンド (Sand)
  • 00/29: 障害・特殊

主要なコード一覧

コード内容欧字表記
10芝・直Turf Str.
11芝・左Turf
12芝・左外Turf
17芝・右Turf
18芝・右外Turf
24ダート・右Dirt
25ダート・左Dirt
29ダート・直Dirt Str.
52サンド・右Sand
55サンド・左Sand
00未設定-

※詳細はJV-Data仕様書「2009.トラックコード」を参照してください。

Available options:
00,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
51,
52,
53,
54,
55,
56,
57,
58,
59
Example:

"17"

​
distance
string

距離 (例: 1800)

​
include
string

関連データをネストして取得します（カンマ区切り）。

利用可能なリレーション:

  • Race: payout
  • RaceEntry: jockey, trainer, owner, foal, stats, training
  • Horse: trainer, owner, breeder, foal, stats, training
​
fields
string

取得するフィールドの絞り込み（カンマ区切り）

​
limit
integer
default:100

1リクエストあたりの最大取得件数

​
page
integer
default:1

ページ番号

Response

Success

​
code
string
required

処理結果コード。成功時は常に 'SUCCESS'。

Example:

"SUCCESS"

​
data
object[]
required

取得されたデータ本体。

​
extensions
object

レスポンスに関する補助情報（メタデータ）。一覧取得時にはページネーション情報が含まれます。