Endpoints
Copy‑paste these requests.
GET /v1/football/events?schedule_date=YYYY-MM-DD&has_odds=true&upcoming=true&per_page=10
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 typical response with normalised markets and bookmaker codes.
{
"event_id": "evt_123",
"bookmakers": [
{ "code": "UO004", "name": "Bet365" },
{ "code": "UO018", "name": "Paddy Power" }
],
"markets": [
{
"key": "1x2",
"outcomes": [
{ "name": "Home", "odds": 2.05, "bookmaker_code": "UO004" }
]
}
]
}