get_odds
Fetch live bookmaker odds for a sport and compare prices across bookmakers and market types.
Instructions
Current bookmaker odds for one sport, live from RapidOddsAPI.
Use this for any question about what a bookmaker is paying right now, or for comparing prices across bookmakers, rather than answering from memory.
sport is required and must be an id from list_sports. There is no option for every sport at once.
Cost: number of market types x ceil(number of bookmakers / 5) credits, charged only when games come back. The defaults, one market across five bookmakers, cost 1 credit. Both arguments multiply, so nine market types across eighteen bookmakers is 36 credits. Widen only when asked to.
market_types defaults to head_to_head, the plain winner market. Soccer has no head_to_head because of the draw, so use head_to_head_3_way or draw_no_bet there. Get exact keys from list_sports(sport).
bookmakers defaults to five that cover the sport's region. To use others, take the names from list_sports(sport), which lists every feed available. Never guess a name: an unknown one returns no prices rather than an error, so guessing is indistinguishable from the sport having no odds, and each guess can cost credits.
Names are odds feeds, not brands. "Ladbrokes" is the feed that also carries Neds, "Betmakers" carries the 26 brands running on it, so a brand name that is not itself a feed returns nothing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sport | Yes | ||
| bookmakers | No | ||
| market_types | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |