Skip to content

get_line_movement

10 creditsTime-seriesPOST /v1/get_line_movement

Data refreshed · changelog

Snapshots of each sportsbook's line before first pitch

Use it when you want how a game's line moved in the days before first pitch, from our snapshots.

Parameters

game_idstringrequired
providerstringoptional
One sportsbook, e.g. DraftKings.
all_snapshotsbooleanoptional
Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time.
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

Notes

  • Over MCP, ask for it in plain English and the client calls get_line_movement itself. Point any MCP client at https://mcp.fastballapi.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.fastballapi.com/v1/get_line_movement \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401569531"
}'

Response

json
{
  "game": {
    "game_id": "401569531",
    "season": 2024,
    "season_type": "regular",
    "date": "2024-06-15",
    "starts_at": "2024-06-15T20:05:00.000Z",
    "status": "final",
    "home": {
      "team_id": "1",
      "abbrev": "BAL",
      "name": "Baltimore Orioles",
      "runs": 6,
      "hits": 11,
      "errors": 0
    },
    "away": {
      "team_id": "22",
      "abbrev": "PHI",
      "name": "Philadelphia Phillies",
      "runs": 2,
      "hits": 7,
      "errors": 1
    },
    "innings": 9,
    "extra_innings": false,
    "venue": "Oriole Park at Camden Yards",
    "city": "Baltimore",
    "attendance": 44555
  },
  "movement": {
    "BetMGM": [
      {
        "captured_at": "2024-06-14T22:35:38.000Z",
        "home_ml": -185,
        "away_ml": 150,
        "home_run_line": null,
        "total": 9
      },
      {
        "captured_at": "2024-06-15T01:30:38.000Z",
        "home_ml": -185,
        "away_ml": 150,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T18:00:38.000Z",
        "home_ml": -190,
        "away_ml": 155,
        "home_run_line": -1.5,
        "total": 8
      }
    ],
    "DraftKings": [
      {
        "captured_at": "2024-06-14T22:20:38.000Z",
        "home_ml": -180,
        "away_ml": 150,
        "home_run_line": null,
        "total": 9
      },
      {
        "captured_at": "2024-06-15T00:30:38.000Z",
        "home_ml": -180,
        "away_ml": 150,
        "home_run_line": null,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T11:55:38.000Z",
        "home_ml": -180,
        "away_ml": 150,
        "home_run_line": -1.5,
        "total": 8.5
      }
    ],
    "ESPN BET": [
      {
        "captured_at": "2024-06-14T22:20:38.000Z",
        "home_ml": -175,
        "away_ml": 150,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T11:55:38.000Z",
        "home_ml": -180,
        "away_ml": 150,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T18:00:38.000Z",
        "home_ml": -195,
        "away_ml": 160,
        "home_run_line": -1.5,
        "total": 8.5
      }
    ],
    "FanDuel": [
      {
        "captured_at": "2024-06-14T22:20:38.000Z",
        "home_ml": -178,
        "away_ml": 150,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T01:30:38.000Z",
        "home_ml": -172,
        "away_ml": 144,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T19:55:38.000Z",
        "home_ml": -188,
        "away_ml": 158,
        "home_run_line": -1.5,
        "total": 8.5
      }
    ],
    "Pinnacle": [
      {
        "captured_at": "2024-06-15T01:30:38.000Z",
        "home_ml": -169,
        "away_ml": 155,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T11:55:38.000Z",
        "home_ml": -171,
        "away_ml": 157,
        "home_run_line": -1.5,
        "total": 8.5
      },
      {
        "captured_at": "2024-06-15T18:00:38.000Z",
        "home_ml": -188,
        "away_ml": 172,
        "home_run_line": -1.5,
        "total": 8.5
      }
    ]
  },
  "snapshots": 48
}

Response fields

gameobject
game.game_idstring
game.seasonnumber
game.season_typestring
game.datestring
game.starts_atstring
game.statusstring
game.homeobject
game.home.team_idstring
game.home.abbrevstring
game.home.namestring
game.home.runsnumber
game.home.hitsnumber
game.home.errorsnumber
game.awayobject
game.away.team_idstring
game.away.abbrevstring
game.away.namestring
game.away.runsnumber
game.away.hitsnumber
game.away.errorsnumber
game.inningsnumber
game.extra_inningsboolean
game.venuestring
game.citystring
game.attendancenumber
movementobject
movement.BetMGM[]array
List of objects
movement.BetMGM[].captured_atstring
movement.BetMGM[].home_mlnumber
movement.BetMGM[].away_mlnumber
movement.BetMGM[].home_run_linenull
movement.BetMGM[].totalnumber

Used in

  • MLB odds history: Each sportsbook's moneyline, run line and total for MLB games, with whether the favourite won and the total went over. Built for backtests. REST or MCP.

Related endpoints

Try it

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