get_odds
Read-only
Use for betting lines: each sportsbook's three-way moneyline (home, draw, away), goal handicap and total (opening and closing from June 2020 for 16 competitions from The Odds API, and from 2024 from ESPN; ESPN's final pre-match line before that), the no-margin probabilities each book's prices imply, and for finished matches the result and whether the total went over against the median close. Pass game_id for one match (5 credits), date for a day's matches (10 credits), or season (optionally a team) for a season of priced matches, 2 credits per match returned, up to 100 a page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | A day's matches, YYYY-MM-DD (UTC). | |
| team | No | With season: one club's matches. | |
| limit | No | With season: matches per page (default 50). | |
| league | No | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. | |
| offset | No | With season: page offset; use next_offset. | |
| season | No | A season of priced matches, by the year it starts (2025 = 2025-26; MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year). | |
| game_id | No | One match. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| tool | No | ||
| count | No | ||
| games | No | ||
| credits | No | ||
| next_offset | No | ||
| estimate_only | No |