Документация oddmind API — справочник футбольного API

Обзор

oddmind API — REST API, который отдаёт JSON по HTTPS. Все эндпоинты только на чтение (GET) и следуют одним правилам: время в UTC в формате ISO 8601, вероятности десятичными числами от 0 до 1, нормализованные ID команд и лиг.

BASEhttps://api.oddmind.app/v1

Авторизация

Передавайте API-ключ в заголовке Authorization в каждом запросе. Ключи выдаются пользователям раннего доступа по email.

cURL/v1/teams/arsenal/form

curl https://api.oddmind.app/v1/teams/arsenal/form?last=5 \
  -H "Authorization: Bearer $ODDMIND_KEY"

JSfetch

const res = await fetch('https://api.oddmind.app/v1/leagues/premier-league/table', {
  headers: { Authorization: `Bearer ${process.env.ODDMIND_KEY}` }
});
const table = await res.json();

Pythonrequests

import os, requests

r = requests.get(
    "https://api.oddmind.app/v1/h2h/liverpool/manchester-city",
    headers={"Authorization": f"Bearer {os.environ['ODDMIND_KEY']}"},
    params={"last": 6},
)
print(r.json()["summary"])

Эндпоинты

Метод	Путь	Описание
GET	`/v1/leagues`	Список лиг с ID, странами и сезонами
GET	`/v1/leagues/{league}/table`	Турнирная таблица с формой · подробнее
GET	`/v1/leagues/{league}/fixtures`	Предстоящие матчи лиги
GET	`/v1/teams/{team}/form`	Форма, игры дома и в гостях, серии · подробнее
GET	`/v1/h2h/{team}/{opponent}`	Личные встречи и сводка · подробнее
GET	`/v1/matches/{match}/probabilities`	Вероятности без маржи, честные коэффициенты, xG · подробнее
GET	`/v1/predictions/archive`	Рассчитанные прогнозы с точностью и калибровкой

Идентификаторы

Лиги, команды и матчи имеют читаемые постоянные ID: premier-league, manchester-city, ipswich-town-vs-nottingham-forest. Названия команд нормализованы между источниками, поэтому у клуба всегда один ID. Полный список — в /v1/leagues.

Лимиты

Тариф	Запросов в день	Цена
Free	100	$0
Pro	10,000	$19/мес
Business	100,000	$49/мес

Каждый ответ содержит заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset. Ответы кэшируются, поэтому повтор того же запроса в течение минуты дешёв для обеих сторон.

Ошибки

Ошибки возвращаются со стандартными HTTP-кодами и JSON-телом:

{ "error": { "code": "rate_limited", "message": "Daily limit reached" } }

HTTP	Код	Значение
400	`invalid_parameter`	Параметр не передан или имеет неверное значение
401	`unauthorized`	API-ключ не передан или неверный
404	`not_found`	Неизвестный ID лиги, команды или матча
429	`rate_limited`	Достигнут дневной лимит запросов — см. Retry-After
5xx	`server_error`	Временная ошибка на нашей стороне — повторите с паузой

Указание источника

Исторические результаты — football-data.co.uk; в каждом ответе есть поле source. Если вы показываете данные публично, оставляйте видимое указание источника. Вероятности, таблицы, сводки формы и архив прогнозов рассчитывает oddmind.app.

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