Odds API

This connector wraps the odds-api.io v3 REST API. Get a free API key at https://odds-api.io and paste it as ODDS_API_KEY — it is injected automatically into every call, you never pass it as a parameter.

Mandatory workflow — odds_get_event_odds needs a concrete eventId and at least one valid bookmakers name; you cannot call it blind:

1. odds_list_sports → the valid sport slug (e.g. football, basketball, tennis). NOTE: there is no soccer_world_cup slug — football competitions are plain football, narrow them with the league slug from step 2.
2. odds_list_leagues (pass the sport slug) → the league slug (e.g. england-premier-league).
3. odds_list_events (pass the sport slug, optionally the league) → each event's numeric id. This is the eventId you pass to odds.
4. odds_list_bookmakers → the exact bookmaker names you may query (e.g. Bet365, Betano PE). Pass them as a comma-separated bookmakers value. all is NOT accepted, and free plans are limited to a small number of selected bookmakers (the API returns a 403 listing your allowed bookmakers if you exceed it).
5. odds_get_event_odds with eventId + bookmakers (+ optional markets).

Common errors (the API returns a JSON error field):

• Missing eventId / Missing bookmakers → required parameter omitted.
• <x> is not a valid bookmaker → use a name from odds_list_bookmakers, not all.
• Access denied. You're allowed max N bookmakers → your plan limits selected bookmakers; pick from the listed allowed set or upgrade.

Times are ISO-8601 UTC (e.g. 2026-06-18T09:00:00Z). Event status is one of notstarted / inprogress / settled.