theoddsapi_event_odds
Retrieve odds for a single sports event, including player props and additional markets not covered by competition-wide odds. Specify sport and event ID to get bookmaker prices and outcomes.
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 |