Перейти к основному содержимому

BookmakerOddsData

Данные коэффициентов одного букмекера. Два режима (параметр odds_stage): без параметра — доска текущей стадии (прематч до начала матча, лайв после), поля stage/updatedAtByStage/isBettingActiveByStage отсутствуют; odds_stage=all — доска ОБЪЕДИНЯЕТ прематч и лайв ПО РЫНКАМ: каждый рынок несёт stage ('prematch' | 'live'); если рынок есть в лайв-доске — отдаётся его лайв-версия целиком, иначе — прематчевая. Правило ставибельности: рынок актуален, только если его стадия активна в isBettingActiveByStage (прематч-рынки после начала матча — архив). Ориентация доски — по командам матча API: сторона 1 (w1, 1x, handicap_1, total_team_1) всегда соответствует homeTeam матча, сторона 2 (w2, x2, handicap_2, total_team_2) — awayTeam, независимо от порядка участников у букмекера

slugstring

Слаг-идентификатор букмекера

Example: melbet
name object

Название букмекера на разных языках

enstring

Название на английском

Example: Match Winner
rustring

Название на русском

Example: Победа в матче
imagestring

URL логотипа букмекера

Example: https://images.api-sport.ru/bookmaker-square-melbet.png
updatedAtintegernullable

Время последнего обновления доски (timestamp в миллисекундах) — когда данные букмекера в последний раз получены от источника (у Pinnacle — время формирования данных источником); при odds_stage=all — максимум по стадиям (пер-стадийные значения в updatedAtByStage). По нему судят о свежести доски: линии, снятые букмекером, исчезают из доски при следующем обновлении

Example: 1234567890000
updatedAtByStage object

Время последнего обновления каждой стадии (timestamp в миллисекундах); null — стадии у книги нет. Присутствует только при odds_stage=all

prematchintegernullable
Example: 1234567880000
liveintegernullable
Example: 1234567890000
isBettingActiveboolean

Активны ли ставки в данный момент; при odds_stage=all — сводный флаг (лайв-стадия, если она есть, иначе прематч), пер-рыночную актуальность определяет isBettingActiveByStage + stage рынка

Example: true
isBettingActiveByStage object

Активность приёма ставок по стадиям: рынки со stage неактивной стадии — архивные (например прематч-рынки после начала матча). Присутствует только при odds_stage=all

prematchboolean
Example: false
liveboolean
Example: true
markets object

Рынки ставок. Ключи — слаги рынков из словаря /v2/BkOddsDict.json, значение — объект BkOddsMarket. В пределах вида спорта один и тот же ключ означает один и тот же рынок у всех букмекеров, включая единицу линий (поле unit рынка), поэтому линии разных букмекеров сравниваются по ключу. Основные ключи: 'result' — исход (1X2 основного времени там, где возможна ничья, иначе 2 исхода), 'result_including_overtime' — победитель с учётом овертайма (баскетбол), 'double_chance', 'handicap', 'total', 'total_team_1' / 'total_team_2' — индивидуальные тоталы homeTeam / awayTeam, а также пер-периодные слаги вида '1st_half_total', '2nd_half_handicap', '1st_half_result', '1st_set_winner', '1st_quarter_winner', '1st_set_full_time'. Единица простых ключей (handicap, total, total_team_, asian_, пер-периодные): футбол и хоккей — голы; баскетбол, настольный теннис, волейбол — очки; теннис — геймы (1st_set_* — геймы 1-го сета); киберспорт — раунды. Более крупные единицы и другие показатели — отдельными ключами: 'sets_handicap' / 'total_sets' — сеты (теннис, настольный теннис, волейбол), 'maps_handicap' / 'total_maps' — карты, 'kills_handicap' / 'total_kills' — убийства (киберспорт)

result object

Пример рынка (ключ динамический)

name object

Мультиязычное название рынка

enstring

Название на английском

Example: Match Winner
rustring

Название на русском

Example: Победа в матче
stagestring

Стадия рынка (присутствует только при odds_stage=all): если рынок есть в лайв-доске книги, отдаётся лайв-версия целиком (stage='live'), иначе — прематчевая (stage='prematch'). Рынок ставибелен, только если его стадия активна (isBettingActiveByStage доски); прематч-рынки после начала матча — архив

Possible values: [prematch, live]

Example: live
statusstring

Состояние рынка у источника (всегда присутствует): open — ставки принимаются; suspended — приём ставок по рынку приостановлен букмекером, цены при этом сохраняются. Приостановку передают Marathon, Pinnacle и Pari (у Pari — блокировкой события у букмекера: при блокировке события целиком все его рынки suspended, при частичной помечаются отдельные линии lines[].suspended и исходы suspended); у Melbet и BetBoom значение всегда open — снятый рынок или исход у них просто исчезает из доски (у BetBoom отключённые исходы удаляются). Отдельного состояния «закрыт» нет: при активной доске закрытого рынка в markets нет. status — агрегат: suspended, только когда приостановлены все линии (у рынков с аргументом) или все исходы (у рынков без аргумента); отдельные приостановленные линии помечены lines[].suspended, отдельные исходы — suspended исхода, при status=open. Рынок ставибелен, только если status=open И стадия рынка активна (isBettingActive / isBettingActiveByStage доски)

Possible values: [open, suspended]

Example: open
hasArgumentboolean

Есть ли у рынка аргумент/параметр (например значение тотала). Если true — исходы содержат lines вместо factor

Example: false
unitstring

Единица измерения аргумента линий (присутствует только у рынков с hasArgument=true): goals — голы, points — очки, games — геймы, sets — сеты/партии, maps — карты, rounds — раунды, kills — убийства. В пределах вида спорта один и тот же ключ рынка у всех букмекеров имеет одну и ту же единицу (таблица — в описании BookmakerOddsData.markets), поэтому линии разных букмекеров сравниваются по ключу рынка

Possible values: [goals, points, games, sets, maps, rounds, kills]

Example: games
stakeKeysstring[]

Упорядоченный список ключей исходов

Example: ["w1","x","w2"]
stakes object

Исходы ставок. Ключи — слаги исходов (например 'w1', 'x', 'w2', 'over', 'under', 'handicap_1', 'handicap_2'). Значение каждого ключа — объект BkOddsStake. Сторона 1 (w1, 1x, handicap_1, total_team_1) всегда соответствует homeTeam матча, сторона 2 (w2, x2, handicap_2, total_team_2) — awayTeam, независимо от порядка участников у букмекера

w1 object

Пример исхода (ключ динамический)

name object

Мультиязычное название исхода

enstring

Название на английском

Example: Match Winner
rustring

Название на русском

Example: Победа в матче
factornumber

Коэффициент ставки (для рынков без аргумента, т.е. hasArgument=false)

Example: 1.85
dateUpdateMsintegernullable

Момент последнего изменения цены этого исхода у источника, мс (рынки без аргумента; у рынков с аргументом — в lines[]). Есть у Melbet (у многих прематч-исходов — null) и Pinnacle (время изменения рынка); у Pari — момент, когда изменение цены исхода зафиксировано при обновлении линии букмекера (точность — несколько секунд); у Marathon и BetBoom источник не отдаёт время по исходам — значение равно updatedAt доски. Это не признак свежести: исход на свежей доске (updatedAt) актуален, даже если dateUpdateMs старше на несколько часов — цена просто не менялась

Example: 1234567890000
changedAtintegernullable

Время последнего изменения коэффициента исхода, мс (рынки без аргумента). Сейчас заполняется только у Pinnacle; у остальных поле отсутствует

Example: 1234567890000
limitnumbernullable

Максимальная ставка букмекера по исходу в валюте букмекера (рынки без аргумента; сейчас — Pinnacle). У остальных поле отсутствует

Example: 1200
suspendedboolean

Исход приостановлен у источника (рынки без аргумента; у рынков с аргументом — lines[].suspended): приём ставок на этот исход остановлен, цена сохранена. Присутствует только со значением true и только у букмекеров, передающих приостановку по отдельным исходам (сейчас — Pari); у открытых исходов поля нет. status рынка при этом может оставаться open — он становится suspended, только когда приостановлены все исходы рынка

Example: true
lines object[]

Массив линий с разными аргументами (для рынков с аргументом, hasArgument=true). Отсортирован по argument по возрастанию

  • Array [
  • dateUpdateMsintegernullable

    Момент последнего изменения цены этой линии у источника, мс. Есть у Melbet (у части прематч-линий — null) и Pinnacle; у Pari — момент, когда изменение цены линии зафиксировано при обновлении линии букмекера (точность — несколько секунд); у Marathon и BetBoom источник не отдаёт время по линиям — значение равно updatedAt доски. Это не признак свежести: линия на свежей доске (updatedAt) актуальна, даже если dateUpdateMs старше на несколько часов — цена просто не менялась

    Example: 1234567890000
    factornumber

    Коэффициент ставки

    Example: 1.95
    argumentnumber

    Аргумент/параметр ставки (значение тотала или гандикапа) в единицах рынка (BkOddsMarket.unit). У гандикапов — собственная линия той стороны, к которой относится исход, со знаком с её точки зрения: handicap_1 — фора homeTeam матча, handicap_2 — фора awayTeam. Сравнимая пара — handicap_1 с argument -1.5 и handicap_2 с argument +1.5; соглашение одинаково у всех букмекеров

    Example: 2.5
    changedAtintegernullable

    Время последнего изменения коэффициента этой линии, мс. Заполняется у букмекеров, чей источник отдаёт его (сейчас — Pinnacle); у остальных поле отсутствует

    Example: 1234567890000
    limitnumbernullable

    Максимальная ставка букмекера по линии в валюте букмекера (сейчас — Pinnacle, maxRiskStake); у остальных поле отсутствует

    Example: 1200
    suspendedboolean

    Линия приостановлена у источника: приём ставок по этой линии остановлен, цена сохранена. Присутствует только со значением true и только у букмекеров, передающих приостановку по линиям (Marathon, Pinnacle, Pari); у открытых линий поля нет. status рынка при этом может оставаться open — он становится suspended, только когда приостановлены все линии рынка

    Example: true
  • ]
  • BookmakerOddsData
    {
    "slug": "melbet",
    "name": {
    "en": "Melbet",
    "ru": "Мелбет"
    },
    "image": "https://images.api-sport.ru/bookmaker-square-melbet.png",
    "updatedAt": 1234567890000,
    "updatedAtByStage": {
    "prematch": 1234567880000,
    "live": 1234567890000
    },
    "isBettingActive": true,
    "isBettingActiveByStage": {
    "prematch": false,
    "live": true
    },
    "markets": {
    "result": {
    "name": {
    "en": "Result",
    "ru": "Исход"
    },
    "hasArgument": false,
    "status": "open",
    "stakeKeys": [
    "w1",
    "x",
    "w2"
    ],
    "stakes": {}
    }
    }
    }