# The Odds API AI integration on Definable

> The Odds API provides real-time sports betting odds data from various bookmakers worldwide, covering multiple sports and betting markets.

## What this connects

The Odds API provides real-time sports betting odds data from various bookmakers worldwide, covering multiple sports and betting markets.

Vendor: https://the-odds-api.com/

## Tools available

**8** tools available. First 8:

- `THE_ODDS_API_GET_EVENT_MARKETS` — Get Event Markets — Tool to retrieve available market keys for each bookmaker for a specific event. Returns only recently seen markets - not a comprehensive list. More markets become available as the event's commence time approaches.
- `THE_ODDS_API_GET_EVENT_ODDS` — Get Event Odds — Tool to retrieve odds for a specific event. Use after confirming sport key via THE_ODDS_API_GET_SPORTS and event ID via THE_ODDS_API_GET_EVENTS; mismatched values return empty payloads rather than errors.
- `THE_ODDS_API_GET_EVENTS` — Get Events — Tool to fetch live and upcoming events for a specified sport. Use when you need event listings including odds. All timestamps are UTC. Avoid high-frequency polling; batch requests and implement backoff to prevent throttling.
- `THE_ODDS_API_GET_ODDS` — Get Odds — Tool to fetch live and upcoming event odds for a specified sport, including bookmakers, regions, and markets. Use after retrieving sports via GET_SPORTS; filter by region, market, or event IDs. Response is nested bookmakers → markets → outcomes; not all bookmakers expose every market for every event, so handle missing keys and empty arrays defensively. Combining multiple regions, markets, and eventIds produces large payloads — narrow to one region or specific eventIds where possible.
- `THE_ODDS_API_GET_PARTICIPANTS` — Get Participants — Tool to fetch list of participants (teams or players) for a specified sport. Use after confirming you have a valid sport key.
- `THE_ODDS_API_GET_SCORES` — Get Scores — Tool to return live and recently completed event scores for a sport. Use after selecting a sport key to inspect current and recent game scores. Missing results may indicate unsupported competitions, not absent events. When identifying specific fixtures, match by both team names and date to avoid confusion with multi-leg ties or similarly named teams.
- `THE_ODDS_API_GET_SPORTS` — Get Sports — Tool to retrieve a list of in-season sports. Use when you need sports data; set 'all' to true to include out-of-season sports. Sport keys returned here must be passed to downstream tools like THE_ODDS_API_GET_EVENTS and THE_ODDS_API_GET_EVENT_ODDS — mismatched or guessed keys return empty payloads. Similarly named leagues and qualifier competitions appear as distinct entries with unique keys; verify the exact key before use.
- `THE_ODDS_API_GET_V3_ODDS` — Get Odds (V3 Legacy) — Tool to fetch odds using the legacy V3 API endpoint. Returns upcoming and live games with odds for a given sport, region, and market. Use for legacy integrations; V4 API is recommended for new implementations.

## Auth

Auth schemes: `API_KEY`.

## How agents use The Odds API

Inside a Definable workflow, The Odds API is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → The Odds API** — the Researcher (GPT-5.5) pulls context from The Odds API (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → The Odds API** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into The Odds API (create record, post message, draft email).
- **Designer / Engineer → Distributor → The Odds API** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via The Odds API (attach file, open PR comment, post status).

The Verifier checks every The Odds API call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- gaming — https://definable.ai/apps/category/gaming/
- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/the_odds_api/
- Same category (gaming): https://definable.ai/apps/category/gaming/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt