Line History, Records vs the Close & Market Report (Pro)
line_historyUse this when the user asks how a game's spread, total or moneyline opened and closed, how a player's prop lines moved and how he did against the closing line game by game, which players beat or missed their closing lines most this season, or how the sportsbooks' lines did overall (the market report). Returns, by kind: "game" (a game_id: the consensus and each book's opening and closing numbers, the vig-free market, how the game ended against the close; NFL also how many times the lines moved), "player" (a player_id: per stat his record against the close and a table of finished games with open, close, books, his number and the result, plus his next game's lines), "records" (the league's highest over and under rates against the closing prop line in a stat), "market" (the monthly market report: book margins, how closing lines missed by stat, size, position, month and move, line moves, injury reaction, with the headline numbers and editions). Requires Keel Stats Pro; the answer says so when the account has none. Not for tonight's lines and hit rates: use props_research.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"league": "<league>"
},
"name": "line_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | "game", "player", "records" or "market". Omit: "game" with a game_id, "player" with a player_id, else "market". | |
| stat | No | Optional stat code: narrows a player's history, or picks the records' stat (NBA: "pts", "reb", "ast", "tpm", "pra"…; NFL: "passing_yards", "rushing_yards", "receiving_yards", "receptions"…). | |
| games | No | Optional, kind "player": finished games per stat in the table, newest first (default 10; at most 82 with a `stat`, 20 without). | |
| league | Yes | League ("nba" or "nfl"). | |
| season | No | Optional season year for "records" and "market". Defaults to the season the site shows. | |
| game_id | No | Numeric game ID (from tonight_slate or find_game) for kind "game". | |
| player_id | No | Numeric player ID (from search) for kind "player". |