Endpoints
Copy‑paste these requests.
GET /v1/football/events?schedule_date=YYYY-MM-DD&has_odds=true&upcoming=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 odds response you can render quickly.
{
"event_id": "evt_123",
"odds_format": "decimal",
"updated_at_utc": "2026-04-30T12:34:00Z",
"markets": [
{
"key": "btts",
"outcomes": [
{ "name": "Yes", "odds": 1.82, "bookmaker_code": "UO004" },
{ "name": "No", "odds": 2.06, "bookmaker_code": "UO004" }
]
}
]
}