> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# The Odds API

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

![The Odds API logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/the_odds_api.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=71499431f725f1b29dae46c6428cfde0)

* **Category:** gaming
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 9
* **Triggers:** 0
* **Slug:** `THE_ODDS_API`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Event Markets
>
> **Slug:** `THE_ODDS_API_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.
>
> #### Input Parameters
>
> **sport** `string` *required*
>
> Sport key for which to return market data. Obtained from the /sports endpoint.
>
> **eventId** `string` *required*
>
> Event ID from the /events endpoint. Returns HTTP 404 if the event has expired (completed or cancelled).
>
> **regions** `string` *required*
>
> Determines which bookmakers appear in the response. Multiple regions can be specified as comma-separated values (e.g., 'us,uk'). Each region counts as 1 request per market. Available: uk, us, us2, us\_dfs, us\_ex, eu, au.
>
> **bookmakers** `string`
>
> Comma-separated list of bookmaker keys to return. If both bookmakers and regions are specified, bookmakers takes precedence. Every group of 10 bookmakers counts as 1 request.
>
> **dateFormat** `string ("iso" | "unix")`
>
> Date format for timestamps.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Event Odds
>
> **Slug:** `THE_ODDS_API_GET_EVENT_ODDS`
>
> Retrieve bookmaker odds for a specific upcoming or live event, optionally filtered by market, region, or bookmaker. Outcome descriptions, including player names for player props, are not retained in the response.
>
> #### Input Parameters
>
> **sport** `string` *required*
>
> Sport key (e.g., 'soccer\_epl')
>
> **eventId** `string` *required*
>
> Event ID to look up odds for
>
> **markets** `string`
>
> Comma-separated market keys to include. Before calling this action, call THE\_ODDS\_API\_GET\_EVENT\_MARKETS with the same sport, eventId, and regions/bookmakers, then use only keys returned for that event. Market availability is sport-, event-, and bookmaker-specific and changes over time; do not infer player market keys.
>
> **regions** `string`
>
> Regions to filter bookies by (comma-separated, e.g., 'us,uk,eu,au')
>
> **bookmakers** `string`
>
> Bookmakers to include (comma-separated names)
>
> **dateFormat** `string ("iso" | "unix")`
>
> Date format for timestamps
>
> **oddsFormat** `string ("decimal" | "american")`
>
> Format of odds
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Events
>
> **Slug:** `THE_ODDS_API_GET_EVENTS`
>
> List live and upcoming events for a specified sport, including event IDs, teams, and start times. The event listing does not include odds.
>
> #### Input Parameters
>
> **sport** `string` *required*
>
> Sport key (e.g., 'upcoming', 'soccer\_epl') Retrieve valid sport keys dynamically from GET\_SPORTS rather than hard-coding; mismatched keys return empty odds responses silently.
>
> **markets** `array`
>
> Filter by market types. Comma delimited (h2h, spreads, totals).
>
> **regions** `array`
>
> Filter markets by region. Comma delimited (us, uk, eu, au).
>
> **bookmakers** `array`
>
> Filter by bookmaker keys. Comma delimited.
>
> **dateFormat** `string ("iso" | "unix")`
>
> Date format to return: 'iso' or 'unix'.
>
> **oddsFormat** `string ("decimal" | "american")`
>
> Odds format to return: 'decimal' or 'american'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Historical Events
>
> **Slug:** `THE_ODDS_API_GET_HISTORICAL_EVENTS`
>
> List events for a sport as they appeared in the closest historical snapshot at or before a specified timestamp. Requires a paid usage plan.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> ISO 8601 snapshot timestamp. The closest snapshot at or before this time is returned.
>
> **sport** `string` *required*
>
> Sport key from THE\_ODDS\_API\_GET\_SPORTS.
>
> **eventIds** `array`
>
> Event IDs to include.
>
> **dateFormat** `string ("iso" | "unix")`
>
> Timestamp format in the response.
>
> **commenceTimeTo** `string`
>
> Inclusive ISO 8601 upper bound for event start time.
>
> **commenceTimeFrom** `string`
>
> Inclusive ISO 8601 lower bound for event start time.
>
> **includeRotationNumbers** `boolean`
>
> Include available home and away rotation numbers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Odds
>
> **Slug:** `THE_ODDS_API_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.
>
> #### Input Parameters
>
> **sport** `string` *required*
>
> Sport key (e.g., 'soccer\_epl')
>
> **markets** `array`
>
> Filter by market types. Comma delimited list: h2h, spreads, totals.
>
> **regions** `array` *required*
>
> Filter by region. Comma delimited list of regions: us, uk, eu, au.
>
> **eventIds** `array`
>
> Filter by event IDs. Comma delimited.
>
> **bookmakers** `array`
>
> Filter by bookmaker keys. Comma delimited.
>
> **dateFormat** `string ("iso" | "unix")`
>
> Format of date to return.
>
> **oddsFormat** `string ("decimal" | "american" | "fractional")`
>
> Format of odds to return.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Participants
>
> **Slug:** `THE_ODDS_API_GET_PARTICIPANTS`
>
> List participants for a specified sport: teams for team sports or individuals for individual sports. The list may include inactive participants and does not include players on a team.
>
> #### Input Parameters
>
> **sport** `string` *required*
>
> The key identifying the sport (path parameter). Examples include 'soccer\_epl', 'upcoming', etc. Must exactly match a key returned by THE\_ODDS\_API\_GET\_SPORTS; mismatched keys return empty payloads rather than an error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Scores
>
> **Slug:** `THE_ODDS_API_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.
>
> #### Input Parameters
>
> **sport** `string` *required*
>
> Sport key (e.g., 'soccer\_epl', 'upcoming')
>
> **daysFrom** `integer`
>
> Restrict to games starting within X days (1-3, default 1)
>
> **dateFormat** `string ("iso" | "unix")`
>
> Date/time format: 'iso' for RFC3339 strings or 'unix' timestamps
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Sports
>
> **Slug:** `THE_ODDS_API_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.
>
> #### Input Parameters
>
> **all** `boolean`
>
> Whether to include all sports (in and out of season)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Odds (V3 Legacy)
>
> **Slug:** `THE_ODDS_API_GET_V3_ODDS`
>
> 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.
>
> #### Input Parameters
>
> **mkt** `string ("h2h" | "spreads" | "totals" | "outrights")`
>
> Market type: h2h (default), spreads, totals, or outrights.
>
> **sport** `string` *required*
>
> Sport key from /sports endpoint. Use 'upcoming' to get live and next 8 games across all sports.
>
> **region** `string ("au" | "uk" | "eu" | "us")` *required*
>
> Bookmaker region: au, uk, eu, or us.
>
> **dateFormat** `string ("iso" | "unix")`
>
> Timestamp format: unix (default) or iso.
>
> **oddsFormat** `string ("decimal" | "american")`
>
> Odds format: decimal (default) or american.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
