成績データを取得

POST/tse

テーブル: t_se(成績データ)

レース確定後の成績データを取得します。着順、タイム、オッズなど。

リクエストURL

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

クエリパラメータ

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

リクエストボディ

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

リクエスト例

レースの成績

{
  "racekey": "05250101"
}

日付で取得

{
  "racedate": "20251228"
}

サンプルコード

import requests

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

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

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/tse",
    "membershipLimit": "paid members",
    "result_count": 1,
    "data": [
      {
        "data_classification": "1",
        "resultkey": "1910181420240210",
        "racedate": "20240210",
        "racekey": "05240101",
        "horse_number": "01",
        "horse_id": "2328aaa95a05",
        "horse_name": "エコロブルーム",
        "order_of_finish": "sample",
        "margin": "sample",
        "trouble_classification": "sample",
        "time_record": "sample",
        "confirmed_win_odds": "sample",
        "confirmed_win_popularity": "sample",
        "confirmed_place_odds": "sample",
        "morning_place_odds": "sample",
        "winning_horse": "sample",
        "winner_horse_id": "6dfc6ffb91f7",
        "time_deff": "sample",
        "corner1_order": "sample",
        "corner2_order": "sample",
        "corner3_order": "sample",
        "corner4_order": "sample",
        "first3f_time": "sample",
        "later3f_time": "sample",
        "first3f_deff": "sample",
        "later3f_deff": "sample",
        "race_kyakushitsu": "sample",
        "idm": "sample",
        "idm_rawscore": "sample",
        "correction_value_track_diff": "sample",
        "correction_value_pace": "sample",
        "correction_value_start": "sample",
        "correction_value_positioning": "sample",
        "correction_value_corner1": "sample",
        "correction_value_corner4": "sample",
        "correction_value_adverse": "sample",
        "correction_value_adverse_firsthalf": "sample",
        "correction_value_adverse_halfway": "sample",
        "correction_value_adverse_lasthalf": "sample",
        "correction_value_race_detail": "sample",
        "selected_lane_cd": "01",
        "class_cd": "01",
        "body_condition_cd": "01",
        "mind_condition_cd": "01",
        "rising_level_cd": "01",
        "race_pace": "sample",
        "horse_pace": "sample",
        "ten_index": "sample",
        "pace_index": "sample",
        "agari_index": "sample",
        "ichi_index": "sample",
        "horse_weight": "sample",
        "weight_cycling": "sample",
        "bit_cd": "01",
        "updated_at": "20251129"
      }
    ]
  }
}

レスポンスフィールド

パラメータ型必須説明
data_classificationstring-データ区分例: 1
resultkeystring-競走成績キー(血統登録番号8桁+開催日8桁)例: 1910181420240210
racedatestring-開催日(YYYYMMDD)例: 20240210
racekeystring-レースキー例: 05240101
horse_numberstring-馬番例: 01
horse_idstring-馬ID(12桁の英数字)例: 2328aaa95a05
horse_namestring-馬名例: エコロブルーム
order_of_finishstring| null-着順
marginstring| null-着差
trouble_classificationstring| null-異常区分(1:取消 2:除外 3:中止 4:失格 5:降着 6:再騎乗)
time_recordstring| null-走破タイム(1/10秒単位)
confirmed_win_oddsstring| null-確定単勝オッズ
confirmed_win_popularitystring| null-確定単勝人気順
confirmed_place_oddsstring| null-確定複勝オッズ(下限値)
morning_place_oddsstring| null-前日朝の複勝オッズ
winning_horsestring| null-相手馬名。1着馬の行には2着馬、それ以外の行には1着馬の名前が入る(JRDBの仕様)
winner_horse_idstring| null-このレースの1着馬の horse_id。1着馬自身の行では horse_id と一致する(winning_horse とは指す馬が異なるので注意)。1着同着のときは winning_horse と同じ馬を返す例: 6dfc6ffb91f7
time_deffstring| null-タイム差
corner1_orderstring| null-1コーナー通過順位
corner2_orderstring| null-2コーナー通過順位
corner3_orderstring| null-3コーナー通過順位
corner4_orderstring| null-4コーナー通過順位
first3f_timestring| null-前3Fタイム
later3f_timestring| null-後3Fタイム
first3f_deffstring| null-前3Fタイム差
later3f_deffstring| null-後3Fタイム差
race_kyakushitsustring| null-レース脚質コード
idmstring| null-IDM(JRDB指数。この出走の実績値)
idm_rawscorestring| null-素点(補正前のIDM)
correction_value_track_diffstring| null-補正値・馬場差
correction_value_pacestring| null-補正値・ペース
correction_value_startstring| null-補正値・出遅れ
correction_value_positioningstring| null-補正値・位置取り
correction_value_corner1string| null-補正値・1コーナー
correction_value_corner4string| null-補正値・4コーナー
correction_value_adversestring| null-補正値・不利(全体)
correction_value_adverse_firsthalfstring| null-補正値・前半の不利
correction_value_adverse_halfwaystring| null-補正値・中盤の不利
correction_value_adverse_lasthalfstring| null-補正値・後半の不利
correction_value_race_detailstring| null-補正値・レース内容
selected_lane_cdstring| null-コース取りコード
class_cdstring| null-クラスコード
body_condition_cdstring| null-馬体コード
mind_condition_cdstring| null-気配コード
rising_level_cdstring| null-上昇度コード
race_pacestring| null-レースペース
horse_pacestring| null-馬のペース
ten_indexstring| null-テン指数
pace_indexstring| null-ペース指数
agari_indexstring| null-上がり指数
ichi_indexstring| null-位置指数
horse_weightstring| null-馬体重
weight_cyclingstring| null-馬体重増減
bit_cdstring| null-ハミコード
updated_atstring| null-データ更新日時

関連エンドポイント