get_odds

5 creditsMulti-tablePOST /v1/get_odds

Data refreshed Nov 12, 2026 · changelog

Match-winner prices by sportsbook, opening and closing, from mid-2020

Use it when you want each sportsbook's opening and closing match-winner price for one match or a competition.

Parameters

match_idstringoptional: Match id from get_matches.
competitionstringoptional: Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).
seasonstringoptional
datestringoptional: A day of the match (YYYY-MM-DD).
limitintegeroptional: Max matches (default 20).
leagueenum: cricket | test | odi | t20i | ipl | bbl | psl | cpl | blast | hundred | sa20 | ilt20 | county | wbbl | wpl | hundred_womenoptional: League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.

Notes

Over MCP, ask for it in plain English and the client calls get_odds itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.yorkerapi.com/v1/get_odds \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "match_id": "1473511"
}'

Response

json

{
  "matches": [
    {
      "match": {
        "id": "1473511",
        "start_date": "2025-06-03",
        "team1_id": "royal-challengers-bengaluru",
        "team1": "Royal Challengers Bengaluru",
        "team2_id": "punjab-kings",
        "team2": "Punjab Kings",
        "winner_id": "royal-challengers-bengaluru",
        "result": "win"
      },
      "books": 31,
      "lines": [
        {
          "bookmaker": "betfair_ex_au",
          "outcome": "Punjab Kings",
          "open": 2.1,
          "close": 1.99,
          "close_american": -101,
          "snapshots": 7,
          "first_at": "2025-06-02 11:55:36+00",
          "last_at": "2025-06-03 13:45:36+00"
        },
        {
          "bookmaker": "betfair_ex_au",
          "outcome": "Royal Challengers Bangalore",
          "open": 1.9,
          "close": 2,
          "close_american": 100,
          "snapshots": 7,
          "first_at": "2025-06-02 11:55:36+00",
          "last_at": "2025-06-03 13:45:36+00"
        },
        {
          "bookmaker": "betfair_ex_eu",
          "outcome": "Punjab Kings",
          "open": 2.1,
          "close": 1.99,
          "close_american": -101,
          "snapshots": 7,
          "first_at": "2025-06-02 11:55:36+00",
          "last_at": "2025-06-03 13:45:36+00"
        }
      ]
    }
  ],
  "count": 1
}