過去開催データを取得

POST/dka

テーブル: d_ka(過去の開催データ)

過去の馬場状態・馬場差・芝丈・クッション値などを開催日単位で取得します。 列は `/tka` と同一です。

リクエストURL

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

クエリパラメータ

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

リクエストボディ

パラメータ型必須説明
start_racedatestring-開始日(YYYYMMDD形式)例: 20251101
end_racedatestring-終了日(YYYYMMDD形式)例: 20251130
racekeystring-レースキー(8桁)例: 05250101

リクエスト例

期間指定で取得

{
  "start_racedate": "20251101",
  "end_racedate": "20251130"
}

日付で取得

{
  "racedate": "20251129"
}

サンプルコード

import requests

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

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

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

payload = {
  "start_racedate": "20251101",
  "end_racedate": "20251130"
}

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

print(data)

レスポンス

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

サンプルレスポンス

{
  "request": {
    "parameters": {
      "start_racedate": "20251101",
      "end_racedate": "20251130",
      "racekey": "05250101"
    }
  },
  "result": {
    "status": 200,
    "endpoint_uri": "/v1/dka",
    "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

関連エンドポイント