直前情報データを取得

POST/tpd

テーブル: t_pd(直前情報)

パドック指数、オッズ、馬体重などの直前情報を取得します。

リクエストURL

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

クエリパラメータ

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

リクエストボディ

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

リクエスト例

レースの直前情報

{
  "racekey": "05250101"
}

サンプルコード

import requests

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

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

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

payload = {
  "racekey": "05250101"
}

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/tpd",
    "membershipLimit": "paid members",
    "result_count": 1,
    "data": [
      {
        "data_classification": "sample",
        "racedate": "20251129",
        "racekey": "05250101",
        "horse_number": "sample",
        "horse_id": "2328aaa95a05",
        "resultkey": "05250101",
        "horse_name": "サンプル",
        "idm": "sample",
        "jockey_index": "05250101",
        "insideinfo_index": "sample",
        "odds_index": "sample",
        "paddock_index": "sample",
        "this_horse_body_state": "sample",
        "this_horse_mind_state": "sample",
        "integration_index": "sample",
        "change_equipment_flag": "sample",
        "underfoot_info": "sample",
        "withdrawn_flag": "sample",
        "jockey_name": "05250101",
        "jockey_cd": "05250101",
        "weight_to_carry": "sample",
        "apprentice_class": "sample",
        "turf_condition_cd": "01",
        "weather_cd": "01",
        "win_odds": "sample",
        "place_odds": "sample",
        "odds_obtained_time": "sample",
        "horse_weight": "sample",
        "weight_cycling": "sample",
        "this_gear1_cd": "01",
        "this_gear2_cd": "01",
        "this_gear3_cd": "01",
        "this_gear4_cd": "01",
        "this_gear5_cd": "01",
        "this_gear6_cd": "01",
        "this_gear7_cd": "01",
        "this_leg_left_front1_cd": "01",
        "this_leg_left_front2_cd": "01",
        "this_leg_left_front3_cd": "01",
        "this_leg_left_front4_cd": "01",
        "this_leg_right_front1_cd": "01",
        "this_leg_right_front2_cd": "01",
        "this_leg_right_front3_cd": "01",
        "this_leg_right_front4_cd": "01",
        "this_leg_left_back1_cd": "01",
        "this_leg_left_back2_cd": "01",
        "this_leg_left_back3_cd": "01",
        "this_leg_left_back4_cd": "01",
        "this_leg_right_back1_cd": "01",
        "this_leg_right_back2_cd": "01",
        "this_leg_right_back3_cd": "01",
        "this_leg_right_back4_cd": "01",
        "this_leg_all1_cd": "01",
        "this_leg_all2_cd": "01",
        "this_leg_all3_cd": "01",
        "updated_at": "20251129"
      }
    ]
  }
}

レスポンスフィールド

パラメータ型必須説明
data_classificationstring| null-データ区分
racedatestring| null-開催日(YYYYMMDD)
racekeystring| null-レースキー
horse_numberstring| null-馬番
horse_idstring-馬ID(12桁の英数字。馬を一意に識別します)例: 2328aaa95a05
resultkeystring| null-競走成績キー
horse_namestring| null-馬名
idmstring| null-IDM(当日)
jockey_indexstring| null-騎手指数
insideinfo_indexstring| null-情報指数
odds_indexstring| null-オッズ指数
paddock_indexstring| null-パドック指数
this_horse_body_statestring| null-馬体コード(パドックで見た馬体。馬体コード表参照)
this_horse_mind_statestring| null-気配コード(気配コード表参照)
integration_indexstring| null-直前総合指数
change_equipment_flagstring| null-馬具変更情報(0: 変更なし, 1: 変更(通常), 2: 変更(特注))
underfoot_infostring| null-脚元情報の判定(0: 平行線, 1: 良化, 2: 疑問, 3: 悪化)。脚元コード表のコードではない
withdrawn_flagstring| null-取消フラグ
jockey_namestring| null-騎手名
jockey_cdstring| null-騎手コード
weight_to_carrystring| null-負担重量(0.1kg単位)
apprentice_classstring| null-見習い区分(1: ☆1K減, 2: △2K減, 3: ▲3K減)
turf_condition_cdstring| null-馬場状態コード
weather_cdstring| null-天候コード
win_oddsstring| null-単勝オッズ(データ作成時点)
place_oddsstring| null-複勝オッズ(下側)
odds_obtained_timestring| null-オッズ取得時間(HHMM)
horse_weightstring| null-馬体重
weight_cyclingstring| null-馬体重増減
this_gear1_cdstring| null-今走の装着馬具コード1(3桁。馬具コード表参照)
this_gear2_cdstring| null-今走の装着馬具コード2(3桁。馬具コード表参照)
this_gear3_cdstring| null-今走の装着馬具コード3(3桁。馬具コード表参照)
this_gear4_cdstring| null-今走の装着馬具コード4(3桁。馬具コード表参照)
this_gear5_cdstring| null-今走の装着馬具コード5(3桁。馬具コード表参照)
this_gear6_cdstring| null-今走の装着馬具コード6(3桁。馬具コード表参照)
this_gear7_cdstring| null-今走の装着馬具コード7(3桁。馬具コード表参照)
this_leg_left_front1_cdstring| null-今走の脚元コード(左前)1(3桁。脚元コード表参照)
this_leg_left_front2_cdstring| null-今走の脚元コード(左前)2(3桁。脚元コード表参照)
this_leg_left_front3_cdstring| null-今走の脚元コード(左前)3(3桁。脚元コード表参照)
this_leg_left_front4_cdstring| null-今走の脚元コード(左前)4(3桁。脚元コード表参照)
this_leg_right_front1_cdstring| null-今走の脚元コード(右前)1(3桁。脚元コード表参照)
this_leg_right_front2_cdstring| null-今走の脚元コード(右前)2(3桁。脚元コード表参照)
this_leg_right_front3_cdstring| null-今走の脚元コード(右前)3(3桁。脚元コード表参照)
this_leg_right_front4_cdstring| null-今走の脚元コード(右前)4(3桁。脚元コード表参照)
this_leg_left_back1_cdstring| null-今走の脚元コード(左後)1(3桁。脚元コード表参照)
this_leg_left_back2_cdstring| null-今走の脚元コード(左後)2(3桁。脚元コード表参照)
this_leg_left_back3_cdstring| null-今走の脚元コード(左後)3(3桁。脚元コード表参照)
this_leg_left_back4_cdstring| null-今走の脚元コード(左後)4(3桁。脚元コード表参照)
this_leg_right_back1_cdstring| null-今走の脚元コード(右後)1(3桁。脚元コード表参照)
this_leg_right_back2_cdstring| null-今走の脚元コード(右後)2(3桁。脚元コード表参照)
this_leg_right_back3_cdstring| null-今走の脚元コード(右後)3(3桁。脚元コード表参照)
this_leg_right_back4_cdstring| null-今走の脚元コード(右後)4(3桁。脚元コード表参照)
this_leg_all1_cdstring| null-今走の脚元コード(総合)1(3桁。脚元コード表参照)
this_leg_all2_cdstring| null-今走の脚元コード(総合)2(3桁。脚元コード表参照)
this_leg_all3_cdstring| null-今走の脚元コード(総合)3(3桁。脚元コード表参照)
updated_atstring| null-データ更新日時

関連エンドポイント