JRDB-API
v0.1.0β版

開催データを取得

POST/tka

テーブル: t_ka（開催データ）

馬場状態、天候、馬場差、クッション値などの開催情報を取得します。

リクエストURL

POST https://dev.api.bigtime.world/v1/tka?api_key=API_KEY

クエリパラメータ

パラメータ型必須説明
api_keystring必須API Key例: API_KEY

リクエストボディ

パラメータ型必須説明
racedatestring-開催日（YYYYMMDD形式）例: 20251129
racekeystring-レースキー（8桁）例: 05250101

リクエスト例

日付で取得

{
  "racedate": "20251129"
}

サンプルコード

import requests

# ダッシュボードで取得した値をそれぞれ貼り付け
# API_KEY: APIキー（アプリ共通）
# YOUR_AUTH_KEY: 認証キー (x-user-key)

url = "https://dev.api.bigtime.world/v1/tka"

params = {"api_key": "API_KEY"}
headers = {
    "Content-Type": "application/json",
    "x-user-key": "YOUR_AUTH_KEY"
}

payload = {
  "racedate": "20251129"
}

response = requests.post(url, params=params, headers=headers, json=payload)
data = response.json()

print(data)

レスポンス

成功時は以下の形式でデータが返されます。

サンプルレスポンス

{
  "request": {
    "parameters": {
      "racedate": "20251129",
      "racekey": "05250101"
    }
  },
  "result": {
    "status": 200,
    "endpoint_uri": "/v1/tka",
    "membershipLimit": "paid members",
    "result_count": 1,
    "data": [
      {
        "data_classification": "1",
        "holding_classification": "1",
        "holdingkey": "062557",
        "racedate": "20251227",
        "dayofweek_cd": "7",
        "weather_cd": "01",
        "course_cd": "1",
        "turf_condition_cd": "01",
        "track_diff": 0,
        "straight_track_diff1": 0,
        "straight_track_diff2": 0,
        "straight_track_diff3": 0,
        "straight_track_diff4": 0,
        "straight_track_diff5": 0,
        "dirt_condition_cd": "01",
        "dirt_track_diff": 0,
        "turf_species_cd": "01",
        "turf_length": 0,
        "rolling_compaction_flag": "sample",
        "rolling_compaction_width": 0,
        "sand_thickness": 0,
        "sand_thickness_adjastment_flag": "sample",
        "antifreeze_agent_flag": "sample",
        "precipitation_during_the_week": 0,
        "number_of_races": 12,
        "number_of_consecutive_days": 7,
        "number_of_consecutive_holding": 1,
        "cushion_measurement_time": "sample",
        "cushion_value": 0,
        "updated_at": "2025-12-22T16:29:18.862Z"
      }
    ]
  }
}

レスポンスフィールド

パラメータ型必須説明
data_classificationstring-データ区分例: 1
holding_classificationstring-開催区分（1:関東, 2:関西）例: 1
holdingkeystring-開催キー（6桁）例: 062557
racedatestring-開催日（YYYYMMDD）例: 20251227
dayofweek_cdstring-曜日コード（1:日〜7:土）例: 7
weather_cdstring| null-天候コード（1:晴〜6:小雪）
course_cdstring-コースコード例: 1
turf_condition_cdstring| null-芝馬場状態（1:良, 2:稍重, 3:重, 4:不良）
track_diffnumber-芝馬場差例: 0
straight_track_diff1number-直線馬場差1例: 0
straight_track_diff2number-直線馬場差2例: 0
straight_track_diff3number-直線馬場差3例: 0
straight_track_diff4number-直線馬場差4例: 0
straight_track_diff5number-直線馬場差5例: 0
dirt_condition_cdstring| null-ダート馬場状態
dirt_track_diffnumber-ダート馬場差例: 0
turf_species_cdstring| null-芝種類コード
turf_lengthnumber| null-芝刈り高（mm）
rolling_compaction_flagstring| null-ローラー転圧フラグ
rolling_compaction_widthnumber| null-ローラー転圧幅
sand_thicknessnumber| null-砂厚（cm）
sand_thickness_adjastment_flagstring| null-砂厚調整フラグ
antifreeze_agent_flagstring| null-凍結防止剤フラグ
precipitation_during_the_weeknumber| null-中間降水量
number_of_racesinteger-レース数例: 12
number_of_consecutive_daysinteger-連続開催日数例: 7
number_of_consecutive_holdinginteger-連続開催回数例: 1
cushion_measurement_timestring| null-クッション測定時刻
cushion_valuenumber| null-クッション値
updated_atstring-更新日時例: 2025-12-22T16:29:18.862Z

関連エンドポイント

番組データを取得競走馬データを取得前走データを取得前走拡張データを取得