PrizePicks props, tiers, recorded line history, graded results and sportsbook comparisons.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional for public search/fetch; supply Bearer followed by your API key for authenticated data tools.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
PrizePicks lines beside offered sportsbook prices for a league. Use it to see where a line differs from the market. Free plan: prices run 5 minutes behind, and as_of is off.
The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private.
betrivers, kalshi or both comma-separated. Default both.
Exact PrizePicks stat name, case-insensitive, for example Points.
compact: one flat row with each price as book, side, line and number, and limit up to 1000. full: every field, limit up to 50.
The board and the prices as they stood at this instant (ISO 8601 with a time zone). Not combinable with priced_only. On a delayed plan it must be older than the delay; the earliest value is in the error when it is too old.
Projections per page. Up to 50, or up to 1000 with view=compact.
meta.next_cursor from the preceding page.
NBA, NFL or NHL, or several comma-separated, for example NBA,NFL,NHL, to read them in one call.
Case-insensitive substring of the PrizePicks player name.
false: only prices at the PrizePicks line plus each book main over/under line.
true: only projections with at least one linked book price.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http server https://prizepicksapi.com/api/mcp
Headers
Authorization (optional, not in the config above): Optional for public search/fetch; supply Bearer followed by your API key for authenticated data tools.PrizePicks lines beside offered sportsbook prices for a league. Use it to see where a line differs from the market. Free plan: prices run 5 minutes behind, and as_of is off.
| Argument | Type | Description |
|---|---|---|
| book | string | betrivers, kalshi or both comma-separated. Default both. |
| stat | string | Exact PrizePicks stat name, case-insensitive, for example Points. |
| view | string | compact: one flat row with each price as book, side, line and number, and limit up to 1000. full: every field, limit up to 50. |
| as_of | string | The board and the prices as they stood at this instant (ISO 8601 with a time zone). Not combinable with priced_only. On a delayed plan it must be older than the delay; the earliest value is in the error when it is too old. |
| limit | integer | Projections per page. Up to 50, or up to 1000 with view=compact. |
| cursor | string | meta.next_cursor from the preceding page. |
| league | string | NBA, NFL or NHL, or several comma-separated, for example NBA,NFL,NHL, to read them in one call. |
| player | string | Case-insensitive substring of the PrizePicks player name. |
| alt_lines | boolean | false: only prices at the PrizePicks line plus each book main over/under line. |
| priced_only | boolean | true: only projections with at least one linked book price. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"book": {
"type": "string",
"example": "betrivers",
"description": "betrivers, kalshi or both comma-separated. Default both."
},
"stat": {
"type": "string",
"description": "Exact PrizePicks stat name, case-insensitive, for example Points."
},
"view": {
"enum": [
"full",
"compact"
],
"type": "string",
"default": "full",
"description": "compact: one flat row with each price as book, side, line and number, and limit up to 1000. full: every field, limit up to 50."
},
"as_of": {
"type": "string",
"format": "date-time",
"description": "The board and the prices as they stood at this instant (ISO 8601 with a time zone). Not combinable with priced_only. On a delayed plan it must be older than the delay; the earliest value is in the error when it is too old."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 1000,
"minimum": 1,
"description": "Projections per page. Up to 50, or up to 1000 with view=compact."
},
"cursor": {
"type": "string",
"description": "meta.next_cursor from the preceding page."
},
"league": {
"type": "string",
"example": "NBA,NFL,NHL",
"description": "NBA, NFL or NHL, or several comma-separated, for example NBA,NFL,NHL, to read them in one call."
},
"player": {
"type": "string",
"description": "Case-insensitive substring of the PrizePicks player name."
},
"alt_lines": {
"type": "boolean",
"default": true,
"description": "false: only prices at the PrizePicks line plus each book main over/under line."
},
"priced_only": {
"type": "boolean",
"default": false,
"description": "true: only projections with at least one linked book price."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}Required once per account before the data tools work. Say what data your user is looking for and what they want to do with it, in your own words. Ask your user if you do not already know; do not guess or make it up. Costs no quota. Leave out personal data.
| Argument | Type | Description |
|---|---|---|
| agent | string | Your agent or client name. |
| details | object | Any other fields worth telling us, with any names you like, for example language, schedule or team_size. Up to 20. |
| found_us* | string | How your user found this API, or how you did if you found it yourself, for example a web search or a recommendation. Ask if you do not know, and do not guess. Up to 300 characters. |
| use_case* | string | What they want to do with it. 3 to 1000 characters. |
| data_wanted* | string | What data they are looking for: leagues, stats, tiers, history, refresh speed. 3 to 1000 characters. |
{
"type": "object",
"required": [
"data_wanted",
"use_case",
"found_us"
],
"properties": {
"agent": {
"type": "string",
"description": "Your agent or client name."
},
"details": {
"type": "object",
"description": "Any other fields worth telling us, with any names you like, for example language, schedule or team_size. Up to 20.",
"additionalProperties": true
},
"found_us": {
"type": "string",
"description": "How your user found this API, or how you did if you found it yourself, for example a web search or a recommendation. Ask if you do not know, and do not guess. Up to 300 characters."
},
"use_case": {
"type": "string",
"description": "What they want to do with it. 3 to 1000 characters."
},
"data_wanted": {
"type": "string",
"description": "What data they are looking for: leagues, stats, tiers, history, refresh speed. 3 to 1000 characters."
}
}
}The full text of one search result: a player's current lines and recent graded results, a league summary, a guide or an answer. Needs no key. Quote the read time when you state a line.
| Argument | Type | Description |
|---|---|---|
| id* | string | An id from search. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "An id from search."
}
}
}Stable player ids by name, league or team.
| Argument | Type | Description |
|---|---|---|
| team | string | Team code as PrizePicks prints it, or a team id. |
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| league | string | League code. |
| search | string | Case-insensitive name substring, at least 2 characters. |
| person_key | string | Every player id of one person across split leagues. Use person_key from a player or from source_fields. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
Call with device_code from start_signup, every few seconds, until your user has approved. Returns the key once. Store it as an environment variable, never in a repo.
| Argument | Type | Description |
|---|---|---|
| device_code* | string |
{
"type": "object",
"required": [
"device_code"
],
"properties": {
"device_code": {
"type": "string"
}
}
}The board as it stood at a past instant (as_of, ISO 8601 with a time zone). For backtests and point-in-time questions. Free plan: the last 7 days.
| Argument | Type | Description |
|---|---|---|
| stat | string | Exact stat name, case-insensitive. |
| tier | string | Match either selection tier. |
| as_of* | string | ISO 8601 timestamp with a time zone, for example 2026-10-28T01:00:00Z. Must be at or after collection start (meta.collection_started_at) and not in the future; otherwise 400 invalid_query. |
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| league | string | League code, for example NBA. |
| search | string | Case-insensitive player name search. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
Change feed across the board: new, changed, pulled and restored lines. Save next_cursor and pass it back to read only what moved since. This is the cheap way to stay current. Free plan: the last 7 days.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| league | string | Optional league filter. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"league": {
"type": "string",
"description": "Optional league filter."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}Start here. Every league on the board now, with offer counts and available stats, plus which have history and graded results.
| Argument | Type | Description |
|---|---|---|
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}Fictional sample rows in the live response shape, for trying the API without a key. Never present these as real lines.
| Argument | Type | Description |
|---|---|---|
| stat | string | Exact market label. For league=NHL, aliases faceoff_wins, shots_on_goal and goalie_saves map to Faceoffs Won, Shots On Goal and Goalie Saves. |
| tier | string | Match either selection tier. |
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| league | string | One league code or up to 10 comma-separated codes, for example NBA,NFL,NHL. Exact leagues only; NBA does not include NBA1Q. |
| search | string | Case-insensitive player name search. |
| status | string | Live active results must appear in the latest successful scope response and be confirmed within 30 minutes. all includes retained, potentially stale observations. |
| start_after | string | Scheduled event.starts_at at or after this ISO instant, with explicit timezone. Unknown starts excluded. Available on projections only. |
One fixture by id.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| include | string | game_state_history adds every recorded in-play state of the game. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"id",
"user_request"
],
"properties": {
"id": {
"type": "string",
"pattern": "^fx_[0-9a-f]{20}$"
},
"include": {
"enum": [
"game_state_history"
],
"type": "string",
"description": "game_state_history adds every recorded in-play state of the game."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}Games with lines on the board, by league, date or status.
| Argument | Type | Description |
|---|---|---|
| date | string | US Eastern calendar date of the start, YYYY-MM-DD. |
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| league | string | League code. Sibling leagues fold onto their game: NBA1Q lines belong to the NBA fixture. |
| status | string | Fixture status. |
| resolved | boolean | true: only fixtures resolved to a scoreboard event. false: only unresolved. |
| start_after | string | Only fixtures starting at or after this instant. |
| start_before | string | Only fixtures starting before this instant. |
| user_request* | string |
A player's box score line for each past game, newest first: minutes, opponent, home or away, and every stat. Use for recent form and for prop model features. Pass player_id (from get_projections or find_players), or player and league, with last for the most recent N games. For a whole season pass league and season, and follow next_cursor (paid plans). Free plan: the last 10 games per player, and no season-wide reads. Stats are loaded for only some leagues: meta.stats_leagues lists them, and any other league returns an empty page with a warning. SOCCER and TENNIS read every competition listed under them.
| Argument | Type | Description |
|---|---|---|
| date | string | One game date, league local. |
| last | integer | The player's most recent N rows matching the filters. Needs one player. limit and cursor are ignored. |
| team | string | Only this team's players: a code (BOS) or team id (tm_...). Needs a season or date range unless a player or opponent is also sent. |
| view | string | compact is a flat row for bulk reads and allows limit up to 1000. full adds ids, scores and game context, with limit up to 200. |
| limit | integer | Rows per page: up to 200 with view=full, up to 1000 with view=compact. |
| cursor | string | meta.next_cursor from the preceding page. Send the same filters. |
How often one player has gone over, per stat, across their last graded games. Free plan: the last 10 games, with per-game rows from the last 7 days.
| Argument | Type | Description |
|---|---|---|
| last | integer | Number of most recent graded games per stat. |
| stat | string | Exact stat name, case-insensitive. Omit to return every graded stat for the player. |
| tier | string | Which More-side tier to count. |
| league | string | League code. |
| player | string | Exact player name, case-insensitive. Required unless player_id is sent. |
| player_id | string | PrizePicks player ID. Required unless player is sent. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
Past lines supplied by third parties, not recorded by this API. Every row carries provenance. Empty until meta.available_datasets is above 0. Never present these as lines this API observed. Free plan: games from the last 7 days.
| Argument | Type | Description |
|---|---|---|
| to | string | Latest game date, US Eastern, YYYY-MM-DD. |
| from | string | Earliest game date, US Eastern, YYYY-MM-DD. |
| stat | string | Exact stat name, case-insensitive. |
| tier | string | Line tier. |
| limit | integer | Maximum rows per page. |
| cursor | string | meta.next_cursor from the preceding page. |
| league | string | League code, for example NFL. |
| player | string | Partial player name. |
| line_kind | string | What the line is. |
| provenance |
Current third-party injury reports for NBA, NFL, NHL and WNBA.
| Argument | Type | Description |
|---|---|---|
| team | string | Team code (KC), stats team id, or part of the team name. |
| limit | integer | Maximum rows. |
| league | string | NBA, NFL, NHL or WNBA. Omit for all. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"team": {
"type": "string",
"description": "Team code (KC), stats team id, or part of the team name."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 2000,
"minimum": 1,
"description": "Maximum rows."
},
"league": {
"enum": [
"NBA",
"NFL",
"NHL",
"WNBA"
],
"type": "string",
"description": "NBA, NFL, NHL or WNBA. Omit for all."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}Every recorded change to one projection, oldest first. Use an id from get_projections. Free plan: the last 7 days.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"id",
"user_request"
],
"properties": {
"id": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}The reported pick count of one line every 15 minutes, and its value at the start. Use an id from get_projections.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| limit | integer | Maximum rows. |
| cursor | string | next_cursor from the preceding page. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"id",
"user_request"
],
"properties": {
"id": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 200,
"maximum": 1000,
"minimum": 1,
"description": "Maximum rows."
},
"cursor": {
"type": "string",
"description": "next_cursor from the preceding page."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}Developer or Production: latest source-pushed game scores, period, clock and status. Optional league and source filters. Use source=prizepicks for PrizePicks game state; default is polymarket. These are game updates, not projection lines. Always report observed_at and meta.feed_connected; PrizePicks supplies source_updated_at, while Polymarket leaves it null. A connected socket does not mean each game changed this second. If disconnected, say the returned state may be stale.
| Argument | Type | Description |
|---|---|---|
| league | string | Optional league code, for example NBA or NFL. |
| source | string | Game feed. Defaults to polymarket for compatibility. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"league": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,20}$",
"description": "Optional league code, for example NBA or NFL."
},
"source": {
"enum": [
"prizepicks",
"polymarket"
],
"type": "string",
"default": "polymarket",
"description": "Game feed. Defaults to polymarket for compatibility."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}PrizePicks lines and book prices grouped by fixture. Needs fixture_id or league.
| Argument | Type | Description |
|---|---|---|
| date | string | US Eastern calendar date of the start, YYYY-MM-DD. |
| books | string | Books for book_odds: betrivers, kalshi, both comma-separated (default), or none. |
| limit | integer | Fixtures per page. |
| cursor | string | Opaque cursor from meta.next_cursor. |
| league | string | League code. Sibling leagues fold onto their game: NBA1Q lines belong to the NBA fixture. |
| market | string | A market_id, for example player_points. |
| player | string | A player_id (pl_...) or a PrizePicks player id. |
| status | string | Fixture status. |
| main_only | boolean | true: only standard (main) lines. |
| book_lines |
What a team gives up per game to opposing teams, or by=position for what each position records against it. Needs league, one of meta.stats_leagues. Send team, or a season to read every team. Set end_date to read it as of a past day. Free plan: one team, its last 10 games.
| Argument | Type | Description |
|---|---|---|
| by | string | team or position. |
| date | string | One game date, league local. |
| last | integer | That team's most recent N games, as one row with season null. Needs team. |
| team | string | The team whose defense you are reading: a code (BOS) or team id (tm_...). |
| limit | integer | Teams per page: up to 100 with by=team, up to 10 with by=position. |
| cursor | string | meta.next_cursor from the preceding page. Send the same filters. |
| league* | string | League code, for example NBA. meta.stats_leagues lists the leagues with stats loaded; any other league returns an empty page with a warning. A segment league from a projection row (NBA1Q) reads as its full league. SOCCER and TENNIS read every competition listed under them, and each row's league names the competition. |
Standard PrizePicks payout tables with per-leg break-even rates.
| Argument | Type | Description |
|---|---|---|
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}The first place to get current PrizePicks lines, with goblin and demon tiers labeled. Filter by one league or comma-separated leagues (NBA,NFL,NHL), stat, player or team search, and tier (standard, goblin, demon). Exact league codes only. Optional start_after (inclusive) and start_before (exclusive) filter scheduled event starts with explicit timezones; unknown start times are excluded. Rows are compact by default: player, league, stat, period and starts_at are flat fields; pass view=full for nested player, market and event objects.
| Argument | Type | Description |
|---|---|---|
| stat | string | Exact market label. For league=NHL, aliases faceoff_wins, shots_on_goal and goalie_saves map to Faceoffs Won, Shots On Goal and Goalie Saves. |
| tier | string | Match either selection tier. |
| view | string | compact returns flat player, league, stat, period, line and starts_at fields; full uses nested player, market and event objects. Both preserve exact league codes and projection IDs. |
| limit | integer | Maximum rows per page. Up to 1000 on /projections with view=compact. |
| cursor | string | Opaque cursor from the preceding page. Changes and history use numeric sequence cursors. |
| league | string | One league code or up to 10 comma-separated codes, for example NBA,NFL,NHL. Exact leagues only; NBA does not include NBA1Q. |
Lines graded against final box scores, NBA and the leagues in meta.leagues_graded: closing line, actual value, over, under, push or void. Free plan: the last 7 days.
| Argument | Type | Description |
|---|---|---|
| date | string | US Eastern game date. |
| stat | string | Exact PrizePicks stat name, case-insensitive, for example Points or Pts+Rebs+Asts. |
| limit | integer | Maximum rows per page. |
| cursor | string | meta.next_cursor from the preceding page (numeric sequence). |
| league | string | League code. meta.leagues_graded lists the leagues graded now. |
| player | string | Case-insensitive substring of the PrizePicks player name. Up to 100 characters. |
| result | string | Filter by outcome. |
| status | string | Filter by grading status. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
PrizePicks lines (NBA, NFL, NHL, before the game) where the BetRivers or Kalshi price for the same player and stat moved materially while the PrizePicks line stayed. Each row has the line, the book move in probability points, when it moved, how long the line has stayed since, and observed_at for both sides. Information about prices, not a prediction or betting advice: say so when you relay it.
| Argument | Type | Description |
|---|---|---|
| book | string | betrivers, kalshi or both comma-separated. Default both. |
| stat | string | Exact PrizePicks stat name, case-insensitive, for example Points. |
| limit | integer | Rows, newest move first. |
| league | string | NBA, NFL or NHL. |
| player | string | Case-insensitive substring of the PrizePicks player name. |
| min_move | integer | Smallest move in the book over probability, in percentage points. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
A team's stats per game with the opponent's beside them, or group_by=season for per-game averages and totals. Needs league, one of meta.stats_leagues. Send team, or a season to read every team. Free plan: one team, its last 10 games.
| Argument | Type | Description |
|---|---|---|
| date | string | One game date, league local. |
| last | integer | The team's most recent N games. Needs team. limit and cursor are ignored. |
| team | string | A team code (BOS) or team id (tm_...). |
| view | string | group_by=game only: compact is flat and allows limit up to 1000. |
| limit | integer | group_by=game: rows, up to 200 with view=full and 1000 with view=compact. group_by=season: teams, up to 100. |
| cursor | string | meta.next_cursor from the preceding page. Send the same filters. |
| league* | string | League code, for example NBA. meta.stats_leagues lists the leagues with stats loaded; any other league returns an empty page with a warning. A segment league from a projection row (NBA1Q) reads as its full league. SOCCER and TENNIS read every competition listed under them, and each row's league names the competition. |
One flat row per graded line for building a prop model: opening and closing line, tier, opponent, home or away, rest days, minutes, actual value, result. Voids left out unless include_void=true. Page with cursor; save rows as you go rather than holding them in the conversation. Free plan: one page, a labeled sample of up to 100 rows from the last 7 days.
| Argument | Type | Description |
|---|---|---|
| to | string | Last US Eastern game date, inclusive. |
| date | string | US Eastern game date. Use this or from and to. |
| from | string | First US Eastern game date, inclusive. |
| stat | string | Exact PrizePicks stat name, case-insensitive. |
| tier | string | Line tier. |
| limit | integer | Rows per page. |
| cursor | string | meta.next_cursor from the previous page, or the X-Next-Cursor header on CSV. |
| league | string | League code. meta.leagues_graded on /results lists the leagues graded now. |
| player |
Current lines by reported pick count, or with sort=change by how fast the count is rising. Most lines report no count. For screens and alerts.
| Argument | Type | Description |
|---|---|---|
| sort | string | count: highest count first. change: biggest rise over window_minutes first; lines with no sample that far back come last. |
| limit | integer | Maximum rows. |
| league | string | Optional league code, for example NBA. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
| window_minutes | integer | How far back change is measured. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"sort": {
"enum": [
"count",
"change"
],
"type": "string",
"default": "count",
"description": "count: highest count first. change: biggest rise over window_minutes first; lines with no sample that far back come last."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows."
},
"league": {
"type": "string",
"description": "Optional league code, for example NBA."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
},
"window_minutes": {
"type": "integer",
"default": 60,
"maximum": 1440,
"minimum": 15,
"description": "How far back change is measured."
}
}
}Find a player, league, guide or answer on prizepicksapi.com. Needs no key. Then call fetch with a result id. Use this when no API key is connected.
| Argument | Type | Description |
|---|---|---|
| query* | string | Words to look for, for example a player name, a league or a question. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Words to look for, for example a player name, a league or a question."
}
}
}Report data or a feature you needed and could not get, wrong data, or anything confusing. Be specific about league, stat, field and what you were trying to do. Leave out personal data. Needs no key and costs no quota.
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| agent | string | Your agent or client name. |
| message* | string | What you needed or what went wrong, 3 to 2000 characters. |
| blocking | boolean | True if this stops the task. |
| endpoint | string | The tool or endpoint involved. |
| use_case | string | What is being built, up to 500 characters. |
{
"type": "object",
"required": [
"message"
],
"properties": {
"kind": {
"enum": [
"missing_data",
"missing_feature",
"wrong_data",
"bug",
"docs",
"praise",
"other"
],
"type": "string",
"default": "missing_data"
},
"agent": {
"type": "string",
"description": "Your agent or client name."
},
"message": {
"type": "string",
"description": "What you needed or what went wrong, 3 to 2000 characters."
},
"blocking": {
"type": "boolean",
"description": "True if this stops the task."
},
"endpoint": {
"type": "string",
"description": "The tool or endpoint involved."
},
"use_case": {
"type": "string",
"description": "What is being built, up to 500 characters."
}
}
}Starts getting a free API key. Say what data your user wants and what they want to do with it; ask them if you do not know, and do not guess. Returns a link for your user to approve in the browser. Show them the link and code, then call finish_signup.
| Argument | Type | Description |
|---|---|---|
| agent | string | Your agent or client name. |
| details | object | Any other fields worth telling us, with any names you like, for example language, schedule or team_size. Up to 20. |
| found_us* | string | How your user found this API, or how you did if you found it yourself, for example a web search or a recommendation. Ask if you do not know, and do not guess. Up to 300 characters. |
| use_case* | string | What they want to do with it. 3 to 1000 characters. |
| data_wanted* | string | What data they are looking for: leagues, stats, tiers, history, refresh speed. 3 to 1000 characters. |
{
"type": "object",
"required": [
"data_wanted",
"use_case",
"found_us"
],
"properties": {
"agent": {
"type": "string",
"description": "Your agent or client name."
},
"details": {
"type": "object",
"description": "Any other fields worth telling us, with any names you like, for example language, schedule or team_size. Up to 20.",
"additionalProperties": true
},
"found_us": {
"type": "string",
"description": "How your user found this API, or how you did if you found it yourself, for example a web search or a recommendation. Ask if you do not know, and do not guess. Up to 300 characters."
},
"use_case": {
"type": "string",
"description": "What they want to do with it. 3 to 1000 characters."
},
"data_wanted": {
"type": "string",
"description": "What data they are looking for: leagues, stats, tiers, history, refresh speed. 3 to 1000 characters."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 3, 2026.
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"team": {
"type": "string",
"description": "Team code as PrizePicks prints it, or a team id."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"league": {
"type": "string",
"description": "League code."
},
"search": {
"type": "string",
"description": "Case-insensitive name substring, at least 2 characters."
},
"person_key": {
"type": "string",
"description": "Every player id of one person across split leagues. Use person_key from a player or from source_fields."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}{
"type": "object",
"required": [
"as_of",
"user_request"
],
"properties": {
"stat": {
"type": "string",
"description": "Exact stat name, case-insensitive."
},
"tier": {
"enum": [
"standard",
"demon",
"goblin",
"unknown"
],
"type": "string",
"description": "Match either selection tier."
},
"as_of": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp with a time zone, for example 2026-10-28T01:00:00Z. Must be at or after collection start (meta.collection_started_at) and not in the future; otherwise 400 invalid_query."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"league": {
"type": "string",
"description": "League code, for example NBA."
},
"search": {
"type": "string",
"description": "Case-insensitive player name search."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| start_before | string | Scheduled event.starts_at before this ISO instant, with explicit timezone. Use the user timezone to convert local noon, respecting daylight saving time. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"stat": {
"type": "string",
"description": "Exact market label. For league=NHL, aliases faceoff_wins, shots_on_goal and goalie_saves map to Faceoffs Won, Shots On Goal and Goalie Saves."
},
"tier": {
"enum": [
"standard",
"demon",
"goblin",
"unknown"
],
"type": "string",
"description": "Match either selection tier."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"league": {
"type": "string",
"description": "One league code or up to 10 comma-separated codes, for example NBA,NFL,NHL. Exact leagues only; NBA does not include NBA1Q."
},
"search": {
"type": "string",
"description": "Case-insensitive player name search."
},
"status": {
"enum": [
"active",
"unavailable",
"all"
],
"type": "string",
"default": "active",
"description": "Live active results must appear in the latest successful scope response and be confirmed within 30 minutes. all includes retained, potentially stale observations."
},
"start_after": {
"type": "string",
"format": "date-time",
"description": "Scheduled event.starts_at at or after this ISO instant, with explicit timezone. Unknown starts excluded. Available on projections only."
},
"start_before": {
"type": "string",
"format": "date-time",
"description": "Scheduled event.starts_at before this ISO instant, with explicit timezone. Use the user timezone to convert local noon, respecting daylight saving time."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "US Eastern calendar date of the start, YYYY-MM-DD."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"league": {
"type": "string",
"description": "League code. Sibling leagues fold onto their game: NBA1Q lines belong to the NBA fixture."
},
"status": {
"enum": [
"unplayed",
"live",
"completed",
"cancelled",
"postponed",
"suspended",
"delayed",
"unknown"
],
"type": "string",
"description": "Fixture status."
},
"resolved": {
"type": "boolean",
"description": "true: only fixtures resolved to a scoreboard event. false: only unresolved."
},
"start_after": {
"type": "string",
"format": "date-time",
"description": "Only fixtures starting at or after this instant."
},
"start_before": {
"type": "string",
"format": "date-time",
"description": "Only fixtures starting before this instant."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| league |
| string |
| League code, for example NBA. meta.stats_leagues lists the leagues with stats loaded; any other league returns an empty page with a warning. A segment league from a projection row (NBA1Q) reads as its full league. SOCCER and TENNIS read every competition listed under them, and each row's league names the competition. |
| player | string | Exact player name, case-insensitive. Needs league. A name shared by two players returns 400 listing their ids. |
| season | string | Season label, as listed in meta.coverage.seasons: 2025-26, or 2026 in single-year leagues. |
| end_date | string | Games on or before this league-local date. For a feature as it stood before a game, set this to the day before. |
| opponent | string | Only games against this team: a code or team id. |
| position | string | Position as the box score lists it, for example G, F or C. |
| player_id | string | A player_id (pl_...) from /players or /projections, or a stats_player_id (sp_...) from /results. A pl_ id needs no league. An sp_ id needs league. |
| start_date | string | Games on or after this league-local date. |
| include_dnp | boolean | true: also return games the player was listed for and did not play. |
| season_type | string | regular, postseason, play_in or preseason, where the league has them. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "One game date, league local."
},
"last": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "The player's most recent N rows matching the filters. Needs one player. limit and cursor are ignored."
},
"team": {
"type": "string",
"description": "Only this team's players: a code (BOS) or team id (tm_...). Needs a season or date range unless a player or opponent is also sent."
},
"view": {
"enum": [
"full",
"compact"
],
"type": "string",
"default": "compact",
"description": "compact is a flat row for bulk reads and allows limit up to 1000. full adds ids, scores and game context, with limit up to 200."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 1000,
"minimum": 1,
"description": "Rows per page: up to 200 with view=full, up to 1000 with view=compact."
},
"cursor": {
"type": "string",
"description": "meta.next_cursor from the preceding page. Send the same filters."
},
"league": {
"type": "string",
"description": "League code, for example NBA. meta.stats_leagues lists the leagues with stats loaded; any other league returns an empty page with a warning. A segment league from a projection row (NBA1Q) reads as its full league. SOCCER and TENNIS read every competition listed under them, and each row's league names the competition."
},
"player": {
"type": "string",
"description": "Exact player name, case-insensitive. Needs league. A name shared by two players returns 400 listing their ids."
},
"season": {
"type": "string",
"pattern": "^\\d{4}(-\\d{2})?$",
"description": "Season label, as listed in meta.coverage.seasons: 2025-26, or 2026 in single-year leagues."
},
"end_date": {
"type": "string",
"format": "date",
"description": "Games on or before this league-local date. For a feature as it stood before a game, set this to the day before."
},
"opponent": {
"type": "string",
"description": "Only games against this team: a code or team id."
},
"position": {
"type": "string",
"description": "Position as the box score lists it, for example G, F or C."
},
"player_id": {
"type": "string",
"description": "A player_id (pl_...) from /players or /projections, or a stats_player_id (sp_...) from /results. A pl_ id needs no league. An sp_ id needs league."
},
"start_date": {
"type": "string",
"format": "date",
"description": "Games on or after this league-local date."
},
"include_dnp": {
"type": "boolean",
"default": false,
"description": "true: also return games the player was listed for and did not play."
},
"season_type": {
"type": "string",
"description": "regular, postseason, play_in or preseason, where the league has them."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}{
"type": "object",
"required": [
"user_request"
],
"properties": {
"last": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Number of most recent graded games per stat."
},
"stat": {
"type": "string",
"description": "Exact stat name, case-insensitive. Omit to return every graded stat for the player."
},
"tier": {
"enum": [
"standard",
"goblin",
"demon",
"unknown",
"all"
],
"type": "string",
"default": "standard",
"description": "Which More-side tier to count."
},
"league": {
"type": "string",
"default": "NBA",
"description": "League code."
},
"player": {
"type": "string",
"description": "Exact player name, case-insensitive. Required unless player_id is sent."
},
"player_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "PrizePicks player ID. Required unless player is sent."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| string |
| Kind of supplier. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Latest game date, US Eastern, YYYY-MM-DD."
},
"from": {
"type": "string",
"format": "date",
"description": "Earliest game date, US Eastern, YYYY-MM-DD."
},
"stat": {
"type": "string",
"description": "Exact stat name, case-insensitive."
},
"tier": {
"enum": [
"standard",
"goblin",
"demon",
"unknown"
],
"type": "string",
"description": "Line tier."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 1000,
"minimum": 1,
"description": "Maximum rows per page."
},
"cursor": {
"type": "string",
"description": "meta.next_cursor from the preceding page."
},
"league": {
"type": "string",
"description": "League code, for example NFL."
},
"player": {
"type": "string",
"description": "Partial player name."
},
"line_kind": {
"enum": [
"opening",
"closing",
"last_seen",
"snapshot"
],
"type": "string",
"description": "What the line is."
},
"provenance": {
"enum": [
"licensed_vendor",
"partner_supplied",
"public_archive_capture",
"third_party_collector"
],
"type": "string",
"description": "Kind of supplier."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| string |
| pickem (default): only book lines at a number PrizePicks currently offers for that player and stat. all: every alternate line. |
| fixture_id | string | One fixture. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "US Eastern calendar date of the start, YYYY-MM-DD."
},
"books": {
"type": "string",
"example": "betrivers,kalshi",
"description": "Books for book_odds: betrivers, kalshi, both comma-separated (default), or none."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Fixtures per page."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from meta.next_cursor."
},
"league": {
"type": "string",
"description": "League code. Sibling leagues fold onto their game: NBA1Q lines belong to the NBA fixture."
},
"market": {
"type": "string",
"pattern": "^[a-z0-9_]+$",
"description": "A market_id, for example player_points."
},
"player": {
"type": "string",
"description": "A player_id (pl_...) or a PrizePicks player id."
},
"status": {
"enum": [
"unplayed",
"live",
"completed",
"cancelled",
"postponed",
"suspended",
"delayed",
"unknown"
],
"type": "string",
"description": "Fixture status."
},
"main_only": {
"type": "boolean",
"description": "true: only standard (main) lines."
},
"book_lines": {
"enum": [
"pickem",
"all"
],
"type": "string",
"default": "pickem",
"description": "pickem (default): only book lines at a number PrizePicks currently offers for that player and stat. all: every alternate line."
},
"fixture_id": {
"type": "string",
"pattern": "^fx_[0-9a-f]{20}$",
"description": "One fixture."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| season | string | Season label, as listed in meta.coverage.seasons: 2025-26, or 2026 in single-year leagues. |
| end_date | string | Games on or before this league-local date. For a feature as it stood before a game, set this to the day before. |
| position | string | by=position only: return one position. |
| start_date | string | Games on or after this league-local date. |
| season_type | string | regular, postseason, play_in or preseason, where the league has them. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"league",
"user_request"
],
"properties": {
"by": {
"enum": [
"team",
"position"
],
"type": "string",
"default": "team",
"description": "team or position."
},
"date": {
"type": "string",
"format": "date",
"description": "One game date, league local."
},
"last": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "That team's most recent N games, as one row with season null. Needs team."
},
"team": {
"type": "string",
"description": "The team whose defense you are reading: a code (BOS) or team id (tm_...)."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Teams per page: up to 100 with by=team, up to 10 with by=position."
},
"cursor": {
"type": "string",
"description": "meta.next_cursor from the preceding page. Send the same filters."
},
"league": {
"type": "string",
"description": "League code, for example NBA. meta.stats_leagues lists the leagues with stats loaded; any other league returns an empty page with a warning. A segment league from a projection row (NBA1Q) reads as its full league. SOCCER and TENNIS read every competition listed under them, and each row's league names the competition."
},
"season": {
"type": "string",
"pattern": "^\\d{4}(-\\d{2})?$",
"description": "Season label, as listed in meta.coverage.seasons: 2025-26, or 2026 in single-year leagues."
},
"end_date": {
"type": "string",
"format": "date",
"description": "Games on or before this league-local date. For a feature as it stood before a game, set this to the day before."
},
"position": {
"type": "string",
"description": "by=position only: return one position."
},
"start_date": {
"type": "string",
"format": "date",
"description": "Games on or after this league-local date."
},
"season_type": {
"type": "string",
"description": "regular, postseason, play_in or preseason, where the league has them."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| search | string | Case-insensitive player name search. |
| status | string | Live active results must appear in the latest successful scope response and be confirmed within 30 minutes. all includes retained, potentially stale observations. |
| start_after | string | Scheduled event.starts_at at or after this ISO instant, with explicit timezone. Unknown starts excluded. Available on projections only. |
| start_before | string | Scheduled event.starts_at before this ISO instant, with explicit timezone. Use the user timezone to convert local noon, respecting daylight saving time. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"stat": {
"type": "string",
"description": "Exact market label. For league=NHL, aliases faceoff_wins, shots_on_goal and goalie_saves map to Faceoffs Won, Shots On Goal and Goalie Saves."
},
"tier": {
"enum": [
"standard",
"demon",
"goblin",
"unknown"
],
"type": "string",
"description": "Match either selection tier."
},
"view": {
"enum": [
"full",
"compact"
],
"type": "string",
"default": "compact",
"description": "compact returns flat player, league, stat, period, line and starts_at fields; full uses nested player, market and event objects. Both preserve exact league codes and projection IDs."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 1000,
"minimum": 1,
"description": "Maximum rows per page. Up to 1000 on /projections with view=compact."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from the preceding page. Changes and history use numeric sequence cursors."
},
"league": {
"type": "string",
"description": "One league code or up to 10 comma-separated codes, for example NBA,NFL,NHL. Exact leagues only; NBA does not include NBA1Q."
},
"search": {
"type": "string",
"description": "Case-insensitive player name search."
},
"status": {
"enum": [
"active",
"unavailable",
"all"
],
"type": "string",
"default": "active",
"description": "Live active results must appear in the latest successful scope response and be confirmed within 30 minutes. all includes retained, potentially stale observations."
},
"start_after": {
"type": "string",
"format": "date-time",
"description": "Scheduled event.starts_at at or after this ISO instant, with explicit timezone. Unknown starts excluded. Available on projections only."
},
"start_before": {
"type": "string",
"format": "date-time",
"description": "Scheduled event.starts_at before this ISO instant, with explicit timezone. Use the user timezone to convert local noon, respecting daylight saving time."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}{
"type": "object",
"required": [
"user_request"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "US Eastern game date."
},
"stat": {
"type": "string",
"description": "Exact PrizePicks stat name, case-insensitive, for example Points or Pts+Rebs+Asts."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 200,
"minimum": 1,
"description": "Maximum rows per page."
},
"cursor": {
"type": "string",
"pattern": "^\\d{1,18}$",
"description": "meta.next_cursor from the preceding page (numeric sequence)."
},
"league": {
"type": "string",
"description": "League code. meta.leagues_graded lists the leagues graded now."
},
"player": {
"type": "string",
"description": "Case-insensitive substring of the PrizePicks player name. Up to 100 characters."
},
"result": {
"enum": [
"over",
"under",
"push",
"void"
],
"type": "string",
"description": "Filter by outcome."
},
"status": {
"enum": [
"graded",
"void",
"ungraded"
],
"type": "string",
"description": "Filter by grading status."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| max_age_minutes | integer | Only moves first seen within this many minutes. |
| include_reverted | boolean | true also lists moves the book has since undone (book.still_moved false). |
| lookback_minutes | integer | The move is measured against the value this many minutes earlier. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"book": {
"type": "string",
"example": "betrivers",
"description": "betrivers, kalshi or both comma-separated. Default both."
},
"stat": {
"type": "string",
"description": "Exact PrizePicks stat name, case-insensitive, for example Points."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Rows, newest move first."
},
"league": {
"enum": [
"NBA",
"NFL",
"NHL"
],
"type": "string",
"description": "NBA, NFL or NHL."
},
"player": {
"type": "string",
"description": "Case-insensitive substring of the PrizePicks player name."
},
"min_move": {
"type": "integer",
"default": 5,
"maximum": 30,
"minimum": 3,
"description": "Smallest move in the book over probability, in percentage points."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
},
"max_age_minutes": {
"type": "integer",
"default": 60,
"maximum": 180,
"minimum": 15,
"description": "Only moves first seen within this many minutes."
},
"include_reverted": {
"type": "boolean",
"default": false,
"description": "true also lists moves the book has since undone (book.still_moved false)."
},
"lookback_minutes": {
"enum": [
15,
30,
60
],
"type": "integer",
"default": 15,
"description": "The move is measured against the value this many minutes earlier."
}
}
}| season | string | Season label, as listed in meta.coverage.seasons: 2025-26, or 2026 in single-year leagues. |
| end_date | string | Games on or before this league-local date. For a feature as it stood before a game, set this to the day before. |
| group_by | string | game or season. |
| opponent | string | Only games against this team. |
| start_date | string | Games on or after this league-local date. |
| season_type | string | regular, postseason, play_in or preseason, where the league has them. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"league",
"user_request"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "One game date, league local."
},
"last": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "The team's most recent N games. Needs team. limit and cursor are ignored."
},
"team": {
"type": "string",
"description": "A team code (BOS) or team id (tm_...)."
},
"view": {
"enum": [
"full",
"compact"
],
"type": "string",
"default": "full",
"description": "group_by=game only: compact is flat and allows limit up to 1000."
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 1000,
"minimum": 1,
"description": "group_by=game: rows, up to 200 with view=full and 1000 with view=compact. group_by=season: teams, up to 100."
},
"cursor": {
"type": "string",
"description": "meta.next_cursor from the preceding page. Send the same filters."
},
"league": {
"type": "string",
"description": "League code, for example NBA. meta.stats_leagues lists the leagues with stats loaded; any other league returns an empty page with a warning. A segment league from a projection row (NBA1Q) reads as its full league. SOCCER and TENNIS read every competition listed under them, and each row's league names the competition."
},
"season": {
"type": "string",
"pattern": "^\\d{4}(-\\d{2})?$",
"description": "Season label, as listed in meta.coverage.seasons: 2025-26, or 2026 in single-year leagues."
},
"end_date": {
"type": "string",
"format": "date",
"description": "Games on or before this league-local date. For a feature as it stood before a game, set this to the day before."
},
"group_by": {
"enum": [
"game",
"season"
],
"type": "string",
"default": "game",
"description": "game or season."
},
"opponent": {
"type": "string",
"description": "Only games against this team."
},
"start_date": {
"type": "string",
"format": "date",
"description": "Games on or after this league-local date."
},
"season_type": {
"type": "string",
"description": "regular, postseason, play_in or preseason, where the league has them."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}| string |
| Case-insensitive substring of the PrizePicks player name. |
| player_id | string | PrizePicks player id (pp_player_id). |
| include_void | boolean | true also returns void rows, with reason. Default false. |
| user_request* | string | The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private. |
{
"type": "object",
"required": [
"user_request"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Last US Eastern game date, inclusive."
},
"date": {
"type": "string",
"format": "date",
"description": "US Eastern game date. Use this or from and to."
},
"from": {
"type": "string",
"format": "date",
"description": "First US Eastern game date, inclusive."
},
"stat": {
"type": "string",
"description": "Exact PrizePicks stat name, case-insensitive."
},
"tier": {
"enum": [
"standard",
"goblin",
"demon"
],
"type": "string",
"description": "Line tier."
},
"limit": {
"type": "integer",
"default": 100,
"maximum": 1000,
"minimum": 1,
"description": "Rows per page."
},
"cursor": {
"type": "string",
"description": "meta.next_cursor from the previous page, or the X-Next-Cursor header on CSV."
},
"league": {
"type": "string",
"description": "League code. meta.leagues_graded on /results lists the leagues graded now."
},
"player": {
"type": "string",
"description": "Case-insensitive substring of the PrizePicks player name."
},
"player_id": {
"type": "string",
"description": "PrizePicks player id (pp_player_id)."
},
"include_void": {
"type": "boolean",
"default": false,
"description": "true also returns void rows, with reason. Default false."
},
"user_request": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "The current user task for this call, 3 to 500 characters in one sentence, close to their words. Required on every data call, including follow-ups and pagination. Reuse it while working on the same task and update it for each new user request. Do not ask the user again if their goal is already clear. If no person asked, as in a scheduled job, say what the job is for. Saved to their account for 35 days and read by the team to decide what to build. Leave out names, contact details and anything private."
}
}
}