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, независимо от порядка участников у букмекера
Слаг-идентификатор букмекера
melbetname object
Название букмекера на разных языках
Название на английском
Match WinnerНазвание на русском
Победа в матчеURL логотипа букмекера
https://images.api-sport.ru/bookmaker-square-melbet.pngВремя последнего обновления доски (timestamp в миллисекундах) — когда данные букмекера в последний раз получены от источника (у Pinnacle — время формирования данных источником); при odds_stage=all — максимум по стадиям (пер-стадийные значения в updatedAtByStage). По нему судят о свежести доски: линии, снятые букмекером, исчезают из доски при следующем обновлении
1234567890000updatedAtByStage object
Время последнего обновления каждой стадии (timestamp в миллисекундах); null — стадии у книги нет. Присутствует только при odds_stage=all
12345678800001234567890000Активны ли ставки в данный момент; при odds_stage=all — сводный флаг (лайв-стадия, если она есть, иначе прематч), пер-рыночную актуальность определяет isBettingActiveByStage + stage рынка
trueisBettingActiveByStage object
Активность приёма ставок по стадиям: рынки со stage неактивной стадии — архивные (например прематч-рынки после начала матча). Присутствует только при odds_stage=all
falsetruemarkets 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
Мультиязычное название рынка
Название на английском
Match WinnerНазвание на русском
Победа в матчеСтадия рынка (присутствует только при odds_stage=all): если рынок есть в лайв-доске книги, отдаётся лайв-версия целиком (stage='live'), иначе — прематчевая (stage='prematch'). Рынок ставибелен, только если его стадия активна (isBettingActiveByStage доски); прематч-рынки после начала матча — архив
Possible values: [prematch, live]
liveСостояние рынка у источника (всегда присутствует): 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]
openЕсть ли у рынка аргумент/параметр (например значение тотала). Если true — исходы содержат lines вместо factor
falseЕдиница измерения аргумента линий (присутствует только у рынков с hasArgument=true): goals — голы, points — очки, games — геймы, sets — сеты/партии, maps — карты, rounds — раунды, kills — убийства. В пределах вида спорта один и тот же ключ рынка у всех букмекеров имеет одну и ту же единицу (таблица — в описании BookmakerOddsData.markets), поэтому линии разных букмекеров сравниваются по ключу рынка
Possible values: [goals, points, games, sets, maps, rounds, kills]
gamesУпорядоченный список ключей исходов
["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
Мультиязычное название исхода
Название на английском
Match WinnerНазвание на русском
Победа в матчеКоэффициент ставки (для рынков без аргумента, т.е. hasArgument=false)
1.85Момент последнего изменения цены этого исхода у источника, мс (рынки без аргумента; у рынков с аргументом — в lines[]). Есть у Melbet (у многих прематч-исходов — null) и Pinnacle (время изменения рынка); у Pari — момент, когда изменение цены исхода зафиксировано при обновлении линии букмекера (точность — несколько секунд); у Marathon и BetBoom источник не отдаёт время по исходам — значение равно updatedAt доски. Это не признак свежести: исход на свежей доске (updatedAt) актуален, даже если dateUpdateMs старше на несколько часов — цена просто не менялась
1234567890000Время последнего изменения коэффициента исхода, мс (рынки без аргумента). Сейчас заполняется только у Pinnacle; у остальных поле отсутствует
1234567890000Максимальная ставка букмекера по исходу в валюте букмекера (рынки без аргумента; сейчас — Pinnacle). У остальных поле отсутствует
1200Исход приостановлен у источника (рынки без аргумента; у рынков с аргументом — lines[].suspended): приём ставок на этот исход остановлен, цена сохранена. Присутствует только со значением true и только у букмекеров, передающих приостановку по отдельным исходам (сейчас — Pari); у открытых исходов поля нет. status рынка при этом может оставаться open — он становится suspended, только когда приостановлены все исходы рынка
truelines object[]
Массив линий с разными аргументами (для рынков с аргументом, hasArgument=true). Отсортирован по argument по возрастанию
Момент последнего изменения цены этой линии у источника, мс. Есть у Melbet (у части прематч-линий — null) и Pinnacle; у Pari — момент, когда изменение цены линии зафиксировано при обновлении линии букмекера (точность — несколько секунд); у Marathon и BetBoom источник не отдаёт время по линиям — значение равно updatedAt доски. Это не признак свежести: линия на свежей доске (updatedAt) актуальна, даже если dateUpdateMs старше на несколько часов — цена просто не менялась
1234567890000Коэффициент ставки
1.95Аргумент/параметр ставки (значение тотала или гандикапа) в единицах рынка (BkOddsMarket.unit). У гандикапов — собственная линия той стороны, к которой относится исход, со знаком с её точки зрения: handicap_1 — фора homeTeam матча, handicap_2 — фора awayTeam. Сравнимая пара — handicap_1 с argument -1.5 и handicap_2 с argument +1.5; соглашение одинаково у всех букмекеров
2.5Время последнего изменения коэффициента этой линии, мс. Заполняется у букмекеров, чей источник отдаёт его (сейчас — Pinnacle); у остальных поле отсутствует
1234567890000Максимальная ставка букмекера по линии в валюте букмекера (сейчас — Pinnacle, maxRiskStake); у остальных поле отсутствует
1200Линия приостановлена у источника: приём ставок по этой линии остановлен, цена сохранена. Присутствует только со значением true и только у букмекеров, передающих приостановку по линиям (Marathon, Pinnacle, Pari); у открытых линий поля нет. status рынка при этом может оставаться open — он становится suspended, только когда приостановлены все линии рынка
true{
"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": {}
}
}
}