Skip to main content
GET
/
races
/
{raceId}
/
odds
/
basic
単勝・複勝・枠連
curl --request GET \
  --url https://api.beter-keiba.com/v1/races/{raceId}/odds/basic \
  --header 'Authorization: Bearer <token>'
{
  "code": "SUCCESS",
  "data": {
    "raceId": "ra_2024052605021211",
    "dataType": "3",
    "dataUpdatedAt": 1716715200,
    "announcedAt": 1716704000,
    "entryCount": 18,
    "starterCount": 18,
    "createdAt": 1716704005,
    "id": "o1_2024052605021211",
    "win": {
      "saleFlag": 7,
      "totalVotes": 125000000,
      "odds": [
        {
          "key": "05-12",
          "odds": 46.6,
          "popularity": 9
        }
      ]
    },
    "place": {
      "saleFlag": 7,
      "totalVotes": 98000000,
      "payoutCount": 3,
      "odds": [
        {
          "key": "05",
          "min": 10.2,
          "max": 15.8,
          "popularity": 9
        }
      ]
    },
    "bracket": {
      "saleFlag": 7,
      "totalVotes": 45000000,
      "odds": [
        {
          "key": "05-12",
          "odds": 46.6,
          "popularity": 9
        }
      ]
    }
  }
}

Authorizations

​
Authorization
string
header
required

APIダッシュボードで発行された sk_live_... または sk_test_... キーを入力してください。prefix は mode を示し、両 mode とも同じ API URL で利用できます (sk_live_* = live mode / 本番、sk_test_* = test mode / 開発・自動テスト)。

Path Parameters

​
raceId
string
required

Race entity ID。JV-Data RA レコード由来の合成 PK (開催年月日 8 桁 + 場コード 2 桁 + 開催回 2 桁 + 開催日目 2 桁 + レース番号 2 桁)

Pattern: ^ra_[0-9]{16}$
Example:

"ra_2024052605021211"

Query Parameters

​
cutoff
number

人気順で上位N件のみ取得 (1 以上 28 以下。中央競馬は最大 18 頭、海外国際レースは最大 28 頭まで)

Required range: 1 <= x <= 28
​
minOdds
number

指定したオッズ以上の組み合わせを抽出 (0 以上)

Required range: x >= 0
​
maxOdds
number

指定したオッズ以下の組み合わせを抽出 (0 以上)

Required range: x >= 0
​
horseNumber
number

その馬番が含まれる組み合わせのみ抽出 (1 以上 28 以下。中央競馬は最大 18 頭、海外国際レースは最大 28 頭まで)

Required range: 1 <= x <= 28
​
fields
string

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

Maximum string length: 500

Response

Success

成功レスポンスの共通ラッパー。code は常に "SUCCESS"、data にエンドポイント固有のレスポンスボディ、extensions に補助情報 (pagination や統計など) を含みます。

​
code
string
required

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

Example:

"SUCCESS"

​
data
object
required

基本オッズ (単勝・複勝・枠連)。JV-Data O1 レコードに対応し、レースの最も基本的な券種をまとめて提供します。bet-type 単位 ({ saleFlag, totalVotes, odds[] }) を win / place / bracket のキーで nest し、他の Odds schema と構造を均一化しています。

​
extensions
object

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