get_line_movement
10 creditsTime-seriesPOST /v1/get_line_movement
Data refreshed · changelog
Snapshots of each sportsbook's line before tip-off
Use it when you want how a game's line moved in the days before tip-off, from our snapshots.
Parameters
game_idstringrequired- Game id.
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: nba | wnba | ncaam | ncaaw | nbloptional- League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw, nbl.
Notes
- Over MCP, ask for it in plain English and the client calls
get_line_movementitself. Point any MCP client athttps://mcp.dunkapi.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.dunkapi.com/v1/get_line_movement \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"game_id": "401585601"
}'Response
json
{
"game": {
"game_id": "401585601",
"season": 2024,
"season_type": "regular",
"date": "2024-03-16",
"starts_at": "2024-03-17T00:30:00.000Z",
"status": "final",
"home": {
"team_id": "13",
"abbrev": "LAL",
"name": "Los Angeles Lakers",
"score": 121
},
"away": {
"team_id": "9",
"abbrev": "GS",
"name": "Golden State Warriors",
"score": 128
},
"periods": 4,
"overtime_periods": 0,
"neutral_site": false,
"conference_game": true,
"venue": "crypto.com Arena",
"city": "Los Angeles",
"attendance": 18997
},
"movement": {
"BetMGM": [
{
"captured_at": "2024-03-16T11:55:39.000Z",
"home_ml": -155,
"away_ml": 125,
"home_spread": null,
"total": 235.5
},
{
"captured_at": "2024-03-16T20:50:38.000Z",
"home_ml": -135,
"away_ml": 110,
"home_spread": -1.5,
"total": 233.5
},
{
"captured_at": "2024-03-16T23:50:38.000Z",
"home_ml": -115,
"away_ml": -105,
"home_spread": -1.5,
"total": 233.5
}
],
"DraftKings": [
{
"captured_at": "2024-03-16T11:55:39.000Z",
"home_ml": -155,
"away_ml": 130,
"home_spread": -3,
"total": 236
},
{
"captured_at": "2024-03-16T20:50:38.000Z",
"home_ml": -130,
"away_ml": 110,
"home_spread": -2,
"total": 233
},
{
"captured_at": "2024-03-16T22:50:38.000Z",
"home_ml": -125,
"away_ml": 105,
"home_spread": -2,
"total": 233
}
],
"ESPN BET": [
{
"captured_at": "2024-03-16T11:55:39.000Z",
"home_ml": -145,
"away_ml": 125,
"home_spread": -3.5,
"total": 236.5
},
{
"captured_at": "2024-03-16T20:50:38.000Z",
"home_ml": -130,
"away_ml": 110,
"home_spread": -2.5,
"total": 233.5
},
{
"captured_at": "2024-03-16T23:50:38.000Z",
"home_ml": -120,
"away_ml": 100,
"home_spread": -1.5,
"total": 232.5
}
],
"FanDuel": [
{
"captured_at": "2024-03-16T11:55:39.000Z",
"home_ml": -156,
"away_ml": 132,
"home_spread": -3.5,
"total": 236.5
},
{
"captured_at": "2024-03-16T20:50:38.000Z",
"home_ml": -134,
"away_ml": 114,
"home_spread": -2.5,
"total": 233.5
},
{
"captured_at": "2024-03-16T22:50:38.000Z",
"home_ml": -126,
"away_ml": 108,
"home_spread": -2,
"total": 233.5
}
],
"Pinnacle": [
{
"captured_at": "2024-03-16T11:55:39.000Z",
"home_ml": -145,
"away_ml": 131,
"home_spread": -3,
"total": 236
},
{
"captured_at": "2024-03-16T20:50:38.000Z",
"home_ml": -127,
"away_ml": 115,
"home_spread": -2.5,
"total": 233
},
{
"captured_at": "2024-03-16T22:50:38.000Z",
"home_ml": -124,
"away_ml": 112,
"home_spread": -2,
"total": 233
}
]
},
"snapshots": 35
}Response fields
gameobjectgame.game_idstringgame.seasonnumbergame.season_typestringgame.datestringgame.starts_atstringgame.statusstringgame.homeobjectgame.home.team_idstringgame.home.abbrevstringgame.home.namestringgame.home.scorenumbergame.awayobjectgame.away.team_idstringgame.away.abbrevstringgame.away.namestringgame.away.scorenumbergame.periodsnumbergame.overtime_periodsnumbergame.neutral_sitebooleangame.conference_gamebooleangame.venuestringgame.citystringgame.attendancenumbermovementobjectmovement.BetMGM[]array- List of objects
movement.BetMGM[].captured_atstringmovement.BetMGM[].home_mlnumbermovement.BetMGM[].away_mlnumbermovement.BetMGM[].home_spreadnullmovement.BetMGM[].totalnumber
Used in
- NBA odds history: Each sportsbook's moneyline, spread and total for NBA games from 2013-14, with results against the line. Built for backtests. REST or MCP.
- Guide: How do I get NBA line movement before tip-off in Python?
Related endpoints
get_game5 cr
Takes the game_id this one returns.
One game: both box scores, every player's line, each book's line, win probability
get_player5 cr
Returns the game_id this one takes.
Profile, per-season averages and shooting splits, last 10 games
get_player_games5 cr
Returns the game_id this one takes.
A player's full game log
get_game_probabilities5 cr
Takes the game_id this one returns.
What the market thinks of a game: average implied and fair probability for the moneyline, spreads and totals
Try it
500 free credits every month: 50 calls to get_line_movement, and no card.