Справочные данные (Dictionaries API)

Host: dicts.api.breaking-bet.com

Dictionaries API возвращает набор справочников, необходимых для корректной интерпретации и обработки данных, получаемых из основных API BreakingBet. Эти справочники используются для расшифровки идентификаторов, группировки рынков и сопоставления исходов между букмекерами.

---

Какие данные предоставляет Dictionaries API

Bookmakers (Букмекеры)

Справочник всех поддерживаемых букмекеров.

• Формат: id → название букмекера
• Пример: 7 → Pinnacle, 39 → Bet365, 31 → Betfair Ex
• Используется во всех API-методах, где присутствует bookmaker_id.

Дополнительно возвращается массив live_bookmakers — список bookmaker_id, которые поддерживают live-линии.

---

Sports (Виды спорта)

Справочник видов спорта.

• Формат: id → название спорта
• Пример: 1 → Football, 6 → Tennis, 5 → Basketball
• Используется для фильтрации событий и рынков по виду спорта.

---

Odds Groups (Группы рынков)

Справочник групп, к которым относятся коэффициенты (markets).

• Формат: id → название группы
• Примеры:
  • main — основные исходы
  • totals — тоталы
  • handicaps — форы
  • additional — дополнительные рынки
  • периоды, таймы, карты, угловые, сеты, раунды и т.д.

Используется для логической группировки рынков внутри события.

---

Odds Sections (Секции рынков)

Более высокоуровневая классификация рынков.

• Формат: id → section
• Примеры:
  • main
  • handicaps
  • totals
  • itotals — индивидуальные тоталы
  • additional

Секции применяются для UI, фильтрации и агрегации рынков.

---

Odds Types (Типы исходов)

Один из ключевых справочников API.

• Формат: odds_type_id → объект
• Поля объекта:
  • title_short — короткое обозначение (например TO, AH1, 1X)
  • title_full — полное описание исхода
  • lay — признак lay-ставки (true / false)

Используется для:

• идентификации типа ставки;
• сопоставления эквивалентных рынков между букмекерами;
• построения вилок, коридоров и value-bets.

---

Odds Types Reflections (Зеркальные исходы)

Справочник отражений (mirror / reflection) между типами исходов.

• Формат: odds_type_id → reflected_odds_type_id
• Примеры:
  • AH1 ↔ AH2
  • TO1 ↔ TO2
  • Score 1 Yes ↔ Score 2 Yes

Используется для:

• автоматического сопоставления исходов первой и второй команды;
• построения симметричных рынков;
• нормализации данных между букмекерами.

---

Назначение Dictionaries API

Dictionaries API является базовым сервисом, который:

• декодирует числовые идентификаторы в человекочитаемый вид;
• обеспечивает единый словарь для всех клиентов API;
• используется при работе с:
  • Events API
  • Odds API
  • Arbitrage / Valuebets API
  • Analytics и Historical Data API

Кэширование

Рекомендуется кэшировать ответ Dictionaries API на стороне клиента и обновлять его периодически (например, раз в несколько часов).