Документация по API букмекерских контор и коэффициентов

Сервер

Все запросы проходят через наш первоисходный проект spoyer.com, поэтому адрес в запросах указан через этот домен.

Структура запросов

Используйте следующую строку для получения данных в формате JSON:
(последовательность команд может быть любая, разделяемая символом &)

http://spoyer.com/api/get.php?login=your_login&token=your_token&task=command

Общая информация

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

Bet365

Bet365 - лидер беттинг индустрии и самая технологичная букмекерская компания. Мы предоставляем API данные по всем видам спорта, всем лигам, всем событиям, которые есть на Бет365 с максимально быстрой передачей данных (от 0,1 секунды).

Официальное объяснение запросов от Bet365. Скачать в формате PDF.

Все live игры bet365.

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=bet365live

Live игры bet365 только по 1 виду спорта

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=live&bookmaker=bet365&sport=soccer

Коэффициенты по live игре

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=liveodds&bookmaker=bet365&game_id=90813885

Все прематч игры bet365.

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=pre&bookmaker=bet365&sport=basketball

Коэффициенты по прематч игре

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=preodds&bookmaker=bet365&game_id=90813885

Результаты игры

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=result&bookmaker=bet365&game_id=90813885

Поддерживаемые виды спорта

Спорт	Имя для запроса	Перевод
Soccer	soccer	Футбол
Basketball	basketball	Баскетбол
Ice Hockey	icehockey	Хоккей
Tennis	tennis	Теннис
Badminton	badminton	Бадминтон
Volleyball	volleyball	волейбол
Table Tennis	tabletennis	Настольный теннис
Cricket	cricket	Крикет
Rugby Union	rugbyunion	Регби (молодежка)
Boxing/UFC	boxing	Бокс / UFC
American Football	football	Американский футбол
Snooker	snooker	Снукер
Darts	darts	Дартс
Baseball	baseball	Бейсбол
Rugby League	rugbyleague	Регби
Australian Rules	australianrules	Австралийский футбол
Bowls	bowls	Боулинг
Gaelic Sports	gaelicfootball	Гэльский спорт
Handball	handball	Гандбол
Futsal	futsal	Футзал
Floorball	floorball	Флорбол
Beach Volleyball	beachvolleyball	Пляжный волейбол
Water Polo	waterpolo	Водное поло
Squash	squash	Сквош
E-sport	esport	Кибер-Спорт

1xBet

Данные по 1xBet, включая их дочерние компаний поделены на две группы. Первая группа - это запросы, разделенные по видам спорта и сортированные по играм, также связанные с API по спортивным данным, вторая группа - отображает все данные по 1xBet. Перед работой с данными, ознакомьтесь с их документацией по ссылкам ниже:

Документация

Описания ID

Также в составе БК 1xBet множество дочерних компаний: Melbet, BetWinner, 1хСтавка и другие, поэтому их линия практически идентичная линии 1xBet.

Первая группа

Прематч:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=1xpre&sport=soccer&page=1

&page=1 служит для получения данных по другим страницам. По умолчанию отображается 50 игр на 1 странице.

Live:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=1xlive&sport=soccer

Коэффициенты:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=1xevent&game_id=ID

Результаты:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=1xresult&game_id=ID

Вторая группа

Отобразить все live игры с коэффициентами:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=1xliveall

Отобразить все прематч игры с коэффициентами:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=1xpreall

Поддерживаемые виды спорта для первой группы

Спорт	Имя для запроса	Перевод
Soccer	soccer	Футбол
Volleyball	volleyball	Волейбол
Ice Hockey	icehockey	Хоккей
Basketball	basketball	Баскетбол

Bet Exchange (BetFair)

Мы предоставляем данные по бирже ставок по лицензии «personal» и «development». Отличие лицензий в скорости обновления данных и их объема.

Лицензия «personal»

Прематч:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=betexchangepre&p=1

&p=1 служит для получения данных по другим страницам. По умолчанию отображается 50 игр на 1 странице.

Live:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=betexchangelive&p=1

&p=1 служит для получения данных по другим страницам. По умолчанию отображается 50 игр на 1 странице.

Данные по игре (коэффициенты, рынки, суммы):

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=betexchange&game_id=ID

Лицензия «development»

Сейчас происходит обновление API данных по этому типу лицензии, и запросы по этой группе, для новых клиентов, временно не доступны. Если вам необходимо демо, свяжитесь с нами.

Прематч:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=betexchangepre2v

Live:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=betexchangelive2v

Fonbet

«Фонбет» — самая большая российская букмекерская компания. Мы предоставляем основную роспись их линии по всем видам спорта.

Прематч:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=fonpre

Live:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=fonlive

Unibet

Букмекерская компания Unibet включает в себя несколько дочерних компаний: 888sport и PlayCity, поэтому их линия практически идентичная линии Unibet. Мы предоставляем всю линию этих компаний по всем видам спорта на русском и английском языках.

Получить актуальный список поддерживаемых видов спорта:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=unilistru

Прематч:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=unipre&sport=soccer

Для получения данных на русском языке, используйте команду unipreru

Live:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=unilive

Для получения данных на русском языке, используйте команду uniliveru

Информация и коэффициенты:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=uniodds&game_id=id

Коэффициенты по Азиатским Букмекерам

С августа 2022 года мы сотрудничаем с поставщиком данных по азиатским и английским букмекерским компаниям, среди которых, Pinnacle, Crown, Sbobet, 188Bet, Mansion88, William Hill, Bet365 и другие.

Документация и уточнения по формам сейчас доступны только на английском языке: по играм / по коэффициентам. Данные представляются, как есть, в оригинале (от поставщика) и селективно по рынкам (наши запросы). Используя наши запросы, которые уже сразу выдают нужный тип ставок, можно не использовать документацию, как там интуитивно понятные и не загруженные формы/данные.

Запросы разделены на две группы – коэффициенты и список матчей, игры в обоих группах связаны по айди. Т.е. получая информацию о игре, по этому ID вы можете найти соответствующие коэффициенты.

Список игр:

Сегодняшние игры:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=soccergameslive

Игры на на определенную дату:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=soccergames&day=2022-04-04

Основные данные по играм со временем:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=asianmatchtime

Коэффициенты:

Коэффициенты по типам ставок:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=asian_europeodds

Гандикап (FT/HT): asian_handicap, asian_handicaphalf, Тотал (FT/HT): asian_overunder, asian_overunderhalf

Коэффициенты (оригинал):

Все игры:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=asianodds

Только Live:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=asianlive

Коэффициенты по букмекерам: Sbobet, 10Bet, BWin, 888Sport, 188Bet, CloudBet, BetVictor, Betsson, William Hill, Ladbrokes, предоставляются только по футболу и по основным рынкам - гандикап, тотал, победа.

Вначале необходимо получить айди игр. Для этого нужно отправить запрос на получения прематч или лайф игр. После, используя эти айди, отправляем запрос на получения коэффициентов по этим играм.

Live игры

http://spoyer.com/api/get.php?login=your_login&token=your_token&task=live&sport=soccer

Прематч игры

*Необходимо указывать дату в формате YYYYMMDD или использовать параметр today (сегодняшняя дата).

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=predata&sport=soccer&day=today

Прематч игры с группировкой по страницам

*Необходимо указывать дату в формате YYYYMMDD или использовать параметр today (сегодняшняя дата).

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=predatapage&sport=soccer&day=today&p=1

В этом запросе выводится только 50 записей на одной странице, а скорость генерации страницы занимает от 0.01 секунды. Для получения данных по другим страницам, используйте дополнительные запросы: &p=2 и т.д.

Завершенные игры

*Необходимо указывать дату в формате YYYYMMDD или использовать параметр today (сегодняшняя дата).

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=enddata&sport=soccer&day=today

Коэффициенты

Теперь используя айди игр, можно отправить запрос на получения коэффициентов, для этого используйте этот запрос:

https://spoyer.com/api/get.php?login=your_login&token=your_token&task=odds&game_id=2393776

Статусы матча

#	Значение
0	Не начался
1	В игре (live)
2	Договорная игра*
3	Завершен
4	Отложен
5	Отменен
6	Выигранный из-за неявки команды
7	Прерванный
8	Прерванный и не будет доигран

Возможные Ошибки

Ошибка	Причина
No parameter 'login'	Не указан параметр Login
No parameter 'token'	Не указан параметр Token
No parameter 'task'	Не указан параметр Task
Login 'your_login' not found	Не верный параметр Login
Token 'your_token' not valid	Не верный параметр Token
Token 'your_token' does not work (24.06.2020 15:03:16). Buy new token	Срок вашего токена (ключа) истёк 24 июня 2020 в 15:03:16
Command 'command' is not exist	Указываемая вами команда task=command не существует
Access denied for this command	Для данного токена (ключа) установлен запрет на использование этой команды
Too many requests	Количество запросов за 1 часа для вашего токена (ключа) превысило допустимый предел
Parameter 'day' not exist. Enter the date in YYYYMMDD format, for example day=20200624. Or day=today	Возникает в команде task=pre. Параметр day является обязательным и должен быть в формате YYYYMMDD, т.е. год из 4 цифр, месяц и число. Например, 20200624 (24 июня 2020 г.). А так же можете указать day=today (регистр не важен) для получения сегодняшнего списка прематч игр.
The date must have 8 digits. Enter the date in YYYYMMDD format, for example day=20200624	Дата должна быть из 8 цифр. Подробный формат даты описан строкой выше
This is an incorrect date. Enter the date in YYYYMMDD format, for example day=20200624	Некорректная или несуществующая дата. Например, 32 января.
Enter today's date or later. Format YYYYMMDD. For example day=20200624 or day=today	Укажите сегодняшнюю дату или позже. Такая ошибка возникнет при попытке получить вчерашние или более ранние игры.
Parameter 'game_id' no exist. For example game_id=2071852	Возникает в команде task=odds. Отсутствует параметр game_id
The 'game_id' parameter must contain 7/8 digits	Параметр game_id должен содержать 7/8 цифр
PARAM_INVALID	Не верный параметр game_id
This bookmaker not found or access denied	Возникает, при попытке получить данные несуществующего или неподдерживаемого для вашего ключа букмекера
You can't use the task=odds and bookmaker commands simultaneously	Нельзя одновременно использовать команды task=odds и bookmaker
Error site. Send system administrator (In) Error site. Send system administrator (Out)	Ошибки возникают при больших нагрузках на наш сервер, сервер Букмекерских Компаний, непредвиденных обстоятельствах, изменения структуры данных представителей Букмекерских Компаний и прочих непредвиденных факторов. При их возникновении - свяжитесь с нами.