Skip to content

get_line_movement

10 creditsTime-seriesPOST /v1/get_line_movement

Data refreshed · changelog

Every pregame snapshot by book, the market line over time, and in-play prices

Use it when you want how a match's market moved before the start, book by book, and its prices during the match.

Parameters

match_idstringrequired
Match id from get_matches.
bookmakerstringoptional
One book's key, e.g. "pinnacle".
include_in_playbooleanoptional
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_line_movement itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 10 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_line_movement \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "match_id": "1473511",
  "bookmaker": "pinnacle",
  "include_in_play": true
}'

Response

json
{
  "match_id": "1473511",
  "pregame": [
    {
      "snapshot_at": "2025-06-02 11:55:36+00",
      "bookmaker": "pinnacle",
      "outcome": "Punjab Kings",
      "price_decimal": 2.02,
      "price_american": 102
    },
    {
      "snapshot_at": "2025-06-02 11:55:36+00",
      "bookmaker": "pinnacle",
      "outcome": "Royal Challengers Bangalore",
      "price_decimal": 1.84,
      "price_american": -119
    },
    {
      "snapshot_at": "2025-06-02 13:45:36+00",
      "bookmaker": "pinnacle",
      "outcome": "Punjab Kings",
      "price_decimal": 2.02,
      "price_american": 102
    }
  ],
  "consensus": [
    {
      "snapshot_at": "2025-06-02 11:55:36+00",
      "outcome": "Draw",
      "median_fair_prob": 0.0242,
      "books": 1
    },
    {
      "snapshot_at": "2025-06-02 11:55:36+00",
      "outcome": "Punjab Kings",
      "median_fair_prob": 0.4761,
      "books": 31
    },
    {
      "snapshot_at": "2025-06-02 11:55:36+00",
      "outcome": "Royal Challengers Bangalore",
      "median_fair_prob": 0.5233,
      "books": 31
    }
  ],
  "in_play": [],
  "count": 14
}

Response fields

match_idstring
pregame[]array
List of objects
pregame[].snapshot_atstring
pregame[].bookmakerstring
pregame[].outcomestring
pregame[].price_decimalnumber
pregame[].price_americannumber
consensus[]array
List of objects
consensus[].snapshot_atstring
consensus[].outcomestring
consensus[].median_fair_probnumber
consensus[].booksnumber
in_play[]array
List
countnumber

Related endpoints

Try it

500 free credits every month: 50 calls to get_line_movement, and no card.