Update to BirdieAPI

{
  "description": "Compares the outright winner prices of the four men's majors (Masters, PGA Championship, U.S. Open, Open Championship) across sportsbooks, finds the best price on a golfer, and reads how a price moved from the opening snapshot to the latest pregame snapshot. Use when the user asks about majors odds, who is favoured, which book has the best price, how a golfer's price changed, or a golfer's prices across majors. Do not use for converting prices or devigging -- see odds-analysis. Do not use for non-major tournaments, round, matchup, top-10 or each-way markets -- they are not in the data.",
  "included_files": [],
  "name": "odds-explorer",
  "skill_md_contents": "---\nname: odds-explorer\ndescription: \"Compares the outright winner prices of the four men's majors (Masters, PGA Championship, U.S. Open, Open Championship) across sportsbooks, finds the best price on a golfer, and reads how a price moved from the opening snapshot to the latest pregame snapshot. Use when the user asks about majors odds, who is favoured, which book has the best price, how a golfer's price changed, or a golfer's prices across majors. Do not use for converting prices or devigging -- see odds-analysis. Do not use for non-major tournaments, round, matchup, top-10 or each-way markets -- they are not in the data.\"\nmetadata:\n  version: 1.0.0\n  author: BirdieAPI\n---\n\n# Odds Explorer\n\n> **Default data tool:** BirdieAPI (`birdieapi-tool`).\n> `get_winner_odds` (5 credits per call) is the only odds tool. One call can return a whole major's field, all four majors of a season, or one golfer across the majors.\n\nYou are an expert in golf outright markets. Your goal is to show the user what the books priced, where the best number is, and how the market moved, without implying the data is a live feed.\n\n## What is and is not in the data\n\n- **In:** pre-tournament winner prices for the Masters, PGA Championship, U.S. Open and Open Championship, by sportsbook. Weekly snapshots from 2021 (the first seasons have fewer), plus the 2020 U.S. Open from a single snapshot. Source: The Odds API.\n- **Opening** is the first snapshot a book had for that golfer. **Latest** is the last price before the first round. For past majors the latest price can be up to a week before the first tee time, so it is not a closing line.\n- **Not in:** any other tournament, the LPGA, LIV or DP World Tour, round or matchup markets, finishing-position markets (top 5, top 10, top 20), in-play prices, each-way terms.\n- Books seen in the data include DraftKings, FanDuel, BetMGM, Bovada, BetOnline, ESPN BET, Pinnacle and MyBookie. The set varies by golfer and year.\n\n## When to Use\n\n- \"Who was the favourite at the 2024 Masters and at what price?\"\n- \"Which book had the best number on Scheffler?\"\n- \"How did McIlroy's price move into the US Open?\"\n- One golfer's price across every major he was priced for\n\n## When NOT to Use\n\n- Implied probability, overround, devigging -- see `odds-analysis`\n- Non-major events -- no prices exist; ask for the user's own lines\n\n## Commands Available\n\n| Command | What It Does | Credits |\n|---------|-------------|---------|\n| `get_winner_odds` | Winner prices by golfer and book: opening and latest pregame price with implied probability | 5 |\n| `list_tournaments` | Find a major's `tournament_id` (use `major: true`) | 1 |\n| `search_players` | Find a golfer's `player_id` | 1 |\n\n`get_winner_odds` takes `tournament_id`, or `season` (all four majors), or `player_id`, optionally `major` (`masters`, `pga_championship`, `us_open`, `the_open`), `bookmaker` (e.g. `draftkings`, `pinnacle`) and `limit` (golfers per tournament, favourites first, default 20, max 200). It has no `league` argument.\n\n## Commands That Do NOT Exist\n\n| Not Available | Use Instead |\n|--------------|-------------|\n| `get_odds`, `get_live_odds` | `get_winner_odds` (majors, pre-tournament) |\n| `get_line_movement` | `get_winner_odds` returns opening and latest per book; there is no full time series |\n| `get_closing_line` | The latest pregame snapshot is the nearest thing; label it as such |\n| `get_matchup_odds`, `get_top_10_odds`, `get_round_odds` | Not available |\n| `get_best_book` | Compare the `books[]` array yourself |\n\n## How It Works\n\n**Step 1: Get the id.**\n\n```\nlist_tournaments {\"season\": 2024, \"major\": true}\n```\n\n**Step 2: Pull the market.** For a whole field, favourites first:\n\n```\nget_winner_odds {\"tournament_id\": \"401580344\", \"limit\": 5}\n```\n\nReal response (trimmed): `snapshots 51`, `first_captured_at 2023-04-21`, `last_captured_at 2024-04-05`, `golfers_priced 121`. Each golfer has `median_implied_prob_opening`, `median_implied_prob_latest` and `books[]`. Each book has `opening` and `latest_pregame`, each with `price` (American, positive for longshots), `implied_prob` and `captured_at`, and `snapshots`.\n\nFor Scottie Scheffler at the 2024 Masters:\n\n```\nbetmgm      open +900  (10.0%)  latest +400 (20.0%)\nbetonlineag open +1000 (9.1%)   latest +400 (20.0%)\ndraftkings  open +900  (10.0%)  latest +400 (20.0%)\nfanduel     open +700  (12.5%)  latest +430 (18.9%)\npinnacle    open +1022 (8.9%)   latest +407 (19.7%)\n```\n\n**Step 3: One book, or one golfer.**\n\n```\nget_winner_odds {\"tournament_id\": \"401580344\", \"limit\": 1, \"bookmaker\": \"pinnacle\"}\nget_winner_odds {\"player_id\": \"9478\"}\n```\n\n**Step 4: Find the best price.** For a golfer, the best number at a given snapshot is the highest American price (a +430 beats a +400). Compare the `latest_pregame.price` across `books[]`. Report the spread, not only the best: FanDuel +430 versus +400 elsewhere is a real difference (18.9% versus 20.0% implied).\n\n**Step 5: Read movement.** Compare `opening` with `latest_pregame` per book.\n- Shortening (+900 to +400) means the implied probability rose from 10.0% to 20.0%.\n- Opening dates differ by book (April 2023 for most, October 2023 for Pinnacle in this example). Do not compare an opening price at one book with an opening at another as if they were the same date; use `captured_at`.\n- A weekly snapshot cannot show intra-week or steam moves. Do not claim sharp action from it.\n\n**Step 6: Count snapshots.** `snapshots` per book tells you how dense the series is. Fewer than ten means the movement read is coarse.\n\n## Practical notes on outrights\n\n- Long shots carry the most margin. The 2024 Masters DraftKings latest prices for 115 golfers summed to a raw implied probability of 1.64 (see `odds-analysis`). Do not read a +50000 price as a 0.2% belief.\n- The `median_implied_prob_*` fields are the median across books. The median hides a book that is an outlier; check `books[]` when it matters.\n- A golfer can be priced at a book and absent at another. Missing is not zero.\n\n## Credit Usage\n\n| Operation | Credits | Notes |\n|-----------|---------|-------|\n| One major, all golfers | 5 | `limit` does not change the cost |\n| All four majors of a season | 5 | one call with `season` |\n| One golfer across majors | 5 | `player_id` |\n| Id lookups | 1 each | |\n\nA full pre-tournament scan of one major is about 6 to 8 credits including lookups.\n\n## Anti-patterns\n\n| What the Model Might Do | Why It's Wrong | Do This Instead |\n|---------------------|---------------|-----------------|\n| Call the latest price the closing line | Up to a week before first tee for past majors | Say \"latest pregame snapshot\" |\n| Say \"the books have him at 20%\" | 20.0% is the raw implied probability including margin | Devig first (`odds-analysis`) |\n| Look for top-10 or matchup prices | Not held | Ask for the user's own lines |\n| Infer sharp money from a weekly series | Weekly snapshots cannot show timing | Describe the move and the dates only |\n| Average prices across books to get the \"market\" | Averaging American odds is wrong | Average implied probabilities, or use the median field |\n\n## Output Format\n\n```\n2024 Masters, winner market, latest pregame snapshot (5 Apr 2024)\nScottie Scheffler: +400 at BetMGM, BetOnline, DraftKings, Bovada; +430 at FanDuel (best); +407 Pinnacle\nMove since first snapshot: +900 to +400 at DraftKings (10.0% to 20.0% raw implied)\nSnapshots: 48 (DraftKings). Raw implied probabilities include margin.\n```\n\n## What to Do Next\n\n| What You Found | Next Action | Skill |\n|----------------|-------------|-------|\n| A price to convert or devig | True probabilities | `odds-analysis` |\n| Want the field context | Form and course record | `tournament-preview` |\n"
}