theoddsapi_event_odds
Retrieve odds for a single event, including player props and additional markets. Specify sport and event ID to get bookmaker odds.
Instructions
Odds for ONE event, including player props and other markets not available on the competition-wide call.
Returns: {id, sport_key, commence_time, home_team, away_team, bookmakers:[{key, title, markets:[{key, outcomes:[{name, price, point, description}]}]}]} — a single object, unlike the competition call's array; description carries the player name on prop markets
NOTE: this shape is from the vendor's documentation and has NOT been verified against a live response (we hold no key for this provider). Treat it as approximate — inspect the actual payload before relying on a field name.
Example: One event's markets {"sport": "soccer_epl", "eventId": "", "regions": ["au"], "markets": ["h2h"]}
Auth: needs your own key in THE_ODDS_API_KEY.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sport | Yes | sport_key. Required — part of the URL path. | |
| eventId | Yes | Event id from theoddsapi_odds or theoddsapi_events. Required — part of the URL path. | |
| markets | No | Includes player-prop markets here, e.g. player_pass_tds. | |
| regions | No | Bookmaker regions. | |
| oddsFormat | No | Price format. One of: decimal, american. | decimal |