Endpoints
Copy‑paste these requests.
GET /v1/football/events?schedule_date=YYYY-MM-DD&has_odds=true&per_page=25
GET /v1/football/events/EVENT_ID/odds?package=core&odds_format=decimal
GET /v1/football/events/EVENT_ID/odds/best?odds_format=decimal
Replace EVENT_ID with an event_id returned by the events endpoint.
Sample JSON
A compact event odds response (normalised across bookmakers).
{
"event_id": "evt_123",
"odds_format": "decimal",
"bookmakers": [
{ "code": "UO004", "name": "Bet365" },
{ "code": "UO018", "name": "Paddy Power" }
],
"markets": [
{
"key": "1x2",
"outcomes": [
{ "name": "Home", "odds": 2.05, "bookmaker_code": "UO004" },
{ "name": "Draw", "odds": 3.40, "bookmaker_code": "UO004" },
{ "name": "Away", "odds": 3.85, "bookmaker_code": "UO004" }
]
}
]
}