Tools

The Odds Api

Learn how to use The Odds Api with Composio

Overview

Enum

THE_ODDS_API

Description

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

Authentication Details

api_key
stringRequired

Actions

Tool to fetch live and upcoming events for a specified sport. use when you need event listings including odds.

Action Parameters

bookmakers
array
dateFormat
stringDefaults to iso
markets
array
oddsFormat
stringDefaults to decimal
regions
array
sport
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to retrieve odds for a specific event. use after confirming sport key and event id to obtain bookmaker and market details.

Action Parameters

bookmakers
string
dateFormat
string
eventId
stringRequired
markets
string
oddsFormat
string
regions
string
sport
stringRequired

Action Response

data
object
error
string
successful
boolean
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.

Action Parameters

bookmakers
array
dateFormat
stringDefaults to iso
eventIds
array
markets
array
oddsFormat
stringDefaults to decimal
regions
arrayRequired
sport
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to fetch list of participants (teams or players) for a specified sport. use after confirming you have a valid sport key.

Action Parameters

sport
stringRequired

Action Response

data
array
error
string
successful
boolean
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.

Action Parameters

dateFormat
stringDefaults to iso
daysFrom
integerDefaults to 1
sport
stringRequired

Action Response

data
array
error
string
successful
boolean
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.

Action Parameters

all
boolean

Action Response

data
object
error
string
successful
boolean