Enterprise Endpoints
Advanced endpoints available exclusively to Enterprise tier subscribers.
All endpoints on this page require an Enterprise subscription. Lower tiers will receive a 403 tier_restricted error.
FuturesPermalink for this section
Futures are season-long markets: championship, conference and division winners, MVP and other awards, win totals, to make the playoffs. Two endpoints serve them:
| Endpoint | Returns |
|---|---|
GET /api/v1/futures | The futures: each with its id, its name and the sportsbooks that price it |
GET /api/v1/futures/odds | The futures with their odds: one row per sportsbook, selection, side and line |
List the futures to find the id you want, then pass it as future_id to the odds endpoint.
Canonical futuresPermalink for this section
Sportsbooks name the same market, and the same team or player, in different ways. SharpAPI places each sportsbook’s version of a future on one future with one id and one name, and each version of a team or player on one selection with one name. The prices on a future then compare row for row across sportsbooks.
- Id. The league id, two underscores, then the name in lower snake case:
nfl__super_bowl_winner,nba__regular_season_wins,england_-_premier_league__championship_winner. Take ids from the catalog rather than building them: a name that carries a year (1st Overall Pick 2027) changes id when the year does. - Name. One name per future, in a fixed style:
Super Bowl Winner,AFC South Winner,MVP Winner,Regular Season Wins. - Selection. The team or player a price is on, under its one canonical name:
San Francisco 49ers, and for soccer the full club name,Arsenal FC.normalized_selectionis that name in a form to join on. - Side and line. A row prices one side of a selection:
overorunderat a line on a win-total ladder,yesorno, or no side on an outright. - Future type.
TEAMwhen the selections are teams,PLAYERwhen they are players,UNKNOWNwhen they are neither (a coach, a division, a state).
Row shapesPermalink for this section
| Shape | selection | selection_line | points | Example future |
|---|---|---|---|---|
| Outright | The team, player or other subject: Kansas City Chiefs | null | null | nfl__super_bowl_winner |
| Ladder | The team: Buffalo Bills | over or under | The line: 12.5 | nfl__regular_season_wins |
| Yes/No | The subject: Buffalo Bills | yes or no | null | nfl__to_make_the_playoffs |
| Pair | Two subjects joined by ///: Arizona Cardinals /// Baltimore Ravens | null | null | nfl__super_bowl_matchup |
A pair keeps the order of its two names on an exacta (nfl__super_bowl_exacta) and lists them alphabetically on a matchup.
Yes/No twinsPermalink for this section
Many outrights have a twin future, with the id <id>_yes_no and the name <Name> Yes/No: nfl__super_bowl_winner and nfl__super_bowl_winner_yes_no. The outright holds each price on a subject, with no side. The twin repeats every one of those prices as a yes row, and adds the sportsbook’s price against the subject, when it lists one, as a no row. A no row never appears in the outright. A twin holds yes rows only when no sportsbook lists a price against. Not every outright has a twin: nba__championship_winner has none.
BetMGM’s price on the Kansas City Chiefs, in the outright and in its twin:
| Future | name | selection_line | price |
|---|---|---|---|
nfl__super_bowl_winner | Kansas City Chiefs | null | 900 |
nfl__super_bowl_winner_yes_no | Kansas City Chiefs Yes | yes | 900 |
What is not servedPermalink for this section
A sportsbook’s offer that fits no future is not served: weekly specials, game-scoped props, price boosts and novelty markets. A sportsbook has at most one row per selection, side and line in a future.
GET /api/v1/futuresPermalink for this section
List the futures: every future with the sportsbooks that price it and how much is priced.
GET /api/v1/futuresQuery ParametersPermalink for this section
| Parameter | Type | Default | Description |
|---|---|---|---|
sport | string | all | Filter by sport: one value, case-insensitive (football, basketball, soccer) |
league | string | all | Filter by league: one value, case-insensitive, as /leagues lists it (nfl, nba, england_-_premier_league) |
future_type | string | all | TEAM, PLAYER or UNKNOWN, case-insensitive. Any other value returns an empty data. |
future_id | string | all | One future id, or several comma-separated |
Every future that matches is returned: there is no paging, and sportsbook, limit and offset are ignored if sent.
Example RequestPermalink for this section
curl "https://api.sharpapi.io/api/v1/futures?league=nfl" \
-H "X-API-Key: YOUR_API_KEY"ResponsePermalink for this section
Abridged to three futures. meta.count is the number of futures in the full response.
{
"success": true,
"data": [
{
"id": "nfl__1st_overall_pick_2027",
"name": "1st Overall Pick 2027",
"future_type": "PLAYER",
"sport": "football",
"league": "nfl",
"start_date": "2026-11-07T17:05:00Z",
"books_available": [
"betmgm",
"betonline",
"bwin",
"fanduel"
],
"selection_count": 88,
"odds_count": 198
},
{
"id": "nfl__afc_conference_winner",
"name": "AFC Conference Winner",
"future_type": "TEAM",
"sport": "football",
"league": "nfl",
"start_date": "2026-11-06T01:15:00Z",
"books_available": [
"betonline",
"saba"
],
"selection_count": 16,
"odds_count": 32
},
{
"id": "nfl__afc_conference_winner_yes_no",
"name": "AFC Conference Winner Yes/No",
"future_type": "TEAM",
"sport": "football",
"league": "nfl",
"start_date": "2026-11-06T01:15:00Z",
"books_available": [
"betonline",
"saba"
],
"selection_count": 16,
"odds_count": 32
}
],
"meta": {
"count": 47,
"updated_at": "2026-10-26T12:39:49.784599258Z"
}
}Futures are ordered by league, then id. meta.updated_at is when the futures data in this response was read (RFC 3339), not when the response was sent. Consecutive requests can return the same value.
Future ObjectPermalink for this section
| Field | Type | Description |
|---|---|---|
id | string | The future’s id (nfl__super_bowl_winner). Pass it as future_id to /futures/odds. |
name | string | The future’s name (Super Bowl Winner). A Yes/No twin ends in Yes/No. |
future_type | string | TEAM, PLAYER or UNKNOWN |
sport | string | Sport (football) |
league | string | League id (nfl) |
start_date | string | null | The earliest start any sportsbook sends for this future, in UTC (2027-06-01T19:00:00Z), or null when none sends one. Sportsbooks date a futures market by when it closes or when its event begins, so they can disagree; the earliest is shown, even after it has passed. For one sportsbook’s own date, ask /futures/odds for that sportsbook alone. |
books_available | array of string | The sportsbooks that price this future, sorted by name |
selection_count | integer | Distinct selections in the future |
odds_count | integer | Rows in the future: every sportsbook, selection, side and line |
GET /api/v1/futures/oddsPermalink for this section
Get the futures with their odds. Each future carries one row per sportsbook, selection, side and line.
GET /api/v1/futures/oddsQuery ParametersPermalink for this section
| Parameter | Type | Default | Description |
|---|---|---|---|
future_id | string | - | One future id, or several comma-separated. Required unless league is given. |
league | string | - | Every future in one league: case-insensitive, as /leagues lists it (nfl). Required unless future_id is given. |
sport | string | all | Filter by sport: one value, case-insensitive |
future_type | string | all | TEAM, PLAYER or UNKNOWN, case-insensitive. Any other value returns an empty data. |
sportsbook | string | all | Only rows from these sportsbooks, comma-separated (fanduel,betmgm). books is accepted as an alias. |
team_id | string | all | Only rows on these teams, comma-separated team ids (kansas_city_chiefs). A row whose team_id is null never matches. |
selection | string | all | Only rows on these selections, comma-separated names (Boston Celtics). Case, accents and punctuation are ignored, so CJ Stroud finds C.J. Stroud. A normalized_selection value matches too. |
is_main | boolean | - | true: the main line of each ladder, and every row that is not on a ladder. false: only the other lines of a ladder. Any other value is ignored. |
limit | integer | 50 | Futures per page, from 1 to 200. A value outside that range (0, negative, above 200, not a number) becomes 50. |
offset | integer | 0 | Futures to skip. A negative or non-numeric value becomes 0. |
Pass future_id or league. A request with neither returns 400 validation_error, so no request asks for every row of every league. Some futures hold hundreds of rows (a Super Bowl exacta lists hundreds of team pairs): narrow with sportsbook, team_id, selection or is_main.
Example RequestsPermalink for this section
# One team's price on an outright, from every sportsbook
curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__super_bowl_winner&team_id=kansas_city_chiefs" \
-H "X-API-Key: YOUR_API_KEY"
# A team's win-total ladder
curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nba__regular_season_wins&selection=Boston+Celtics" \
-H "X-API-Key: YOUR_API_KEY"
# Only each sportsbook's main win-total line, for every NFL team
curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__regular_season_wins&is_main=true" \
-H "X-API-Key: YOUR_API_KEY"
# Every NBA future from one sportsbook, two futures per page, second page
curl "https://api.sharpapi.io/api/v1/futures/odds?league=nba&sportsbook=fanduel&limit=2&offset=2" \
-H "X-API-Key: YOUR_API_KEY"ResponsePermalink for this section
Response to the first request. Abridged to two of its six rows; meta.odds_count is the number of rows in the full response.
{
"success": true,
"data": [
{
"id": "nfl__super_bowl_winner",
"name": "Super Bowl Winner",
"future_type": "TEAM",
"sport": "football",
"league": "nfl",
"start_date": "2026-09-10T00:20:00Z",
"odds": [
{
"id": "nfl__super_bowl_winner:betmgm:kansas_city_chiefs",
"sportsbook": "betmgm",
"market": "Super Bowl Winner",
"name": "Kansas City Chiefs",
"selection": "Kansas City Chiefs",
"normalized_selection": "kansas_city_chiefs",
"selection_line": null,
"points": null,
"is_main": true,
"price": 900,
"team_id": "kansas_city_chiefs"
},
{
"id": "nfl__super_bowl_winner:betonline:kansas_city_chiefs",
"sportsbook": "betonline",
"market": "Super Bowl Winner",
"name": "Kansas City Chiefs",
"selection": "Kansas City Chiefs",
"normalized_selection": "kansas_city_chiefs",
"selection_line": null,
"points": null,
"is_main": true,
"price": 850,
"team_id": "kansas_city_chiefs"
}
]
}
],
"pagination": {
"limit": 50,
"offset": 0,
"count": 1,
"total": 1,
"has_more": false,
"next_offset": null
},
"meta": {
"count": 1,
"total": 1,
"odds_count": 6,
"updated_at": "2026-10-26T12:39:49.784599258Z"
}
}Response to the second request, a ladder. Abridged to four of its ten rows: BetMGM prices one line, 51.5, on both sides, and FanDuel lists overs only, at six lines.
{
"success": true,
"data": [
{
"id": "nba__regular_season_wins",
"name": "Regular Season Wins",
"future_type": "TEAM",
"sport": "basketball",
"league": "nba",
"start_date": "2027-06-19T00:40:00Z",
"odds": [
{
"id": "nba__regular_season_wins:betmgm:boston_celtics:over:51.5",
"sportsbook": "betmgm",
"market": "Regular Season Wins",
"name": "Boston Celtics Over 51.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "over",
"points": 51.5,
"is_main": true,
"price": -145,
"team_id": "boston_celtics"
},
{
"id": "nba__regular_season_wins:betmgm:boston_celtics:under:51.5",
"sportsbook": "betmgm",
"market": "Regular Season Wins",
"name": "Boston Celtics Under 51.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "under",
"points": 51.5,
"is_main": true,
"price": 120,
"team_id": "boston_celtics"
},
{
"id": "nba__regular_season_wins:fanduel:boston_celtics:over:49.5",
"sportsbook": "fanduel",
"market": "Regular Season Wins",
"name": "Boston Celtics Over 49.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "over",
"points": 49.5,
"is_main": false,
"price": -220,
"team_id": "boston_celtics"
},
{
"id": "nba__regular_season_wins:fanduel:boston_celtics:over:54.5",
"sportsbook": "fanduel",
"market": "Regular Season Wins",
"name": "Boston Celtics Over 54.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "over",
"points": 54.5,
"is_main": true,
"price": 130,
"team_id": "boston_celtics"
}
]
}
],
"pagination": {
"limit": 50,
"offset": 0,
"count": 1,
"total": 1,
"has_more": false,
"next_offset": null
},
"meta": {
"count": 1,
"total": 1,
"odds_count": 10,
"updated_at": "2026-10-26T12:41:24.754966665Z"
}
}Row ObjectPermalink for this section
Each future in data carries the id, name, future_type, sport and league that /futures lists, a start_date, and an odds array of rows. A future with no row left after the filters is left out.
Here start_date is the earliest start among the sportsbooks the request names with sportsbook (all of them when it names none), or null when none of them sends one, so a request for one sportsbook returns that sportsbook’s own date. team_id, selection and is_main filter rows and leave start_date as it is.
| Field | Type | Description |
|---|---|---|
id | string | The row’s id: the future id, the sportsbook and the normalized_selection, then the side and the points when the row has them, joined by : (nfl__regular_season_wins:betmgm:buffalo_bills:over:12.5). It does not change when the price does. |
sportsbook | string | Sportsbook id (betmgm) |
market | string | The future’s name, repeated on every row |
name | string | A label to display: the selection, then the side with a capital letter, then the points (Kansas City Chiefs, Kansas City Chiefs Yes, Buffalo Bills Over 12.5) |
selection | string | The canonical name of the team or player, the same for every sportsbook (San Francisco 49ers). A pair is two names joined by ///. |
normalized_selection | string | selection in lower case, with every run of characters other than a-z, digits and - replaced by one _: C.J. Stroud is c_j_stroud, Jaren Jackson Jr. is jaren_jackson_jr_. Join rows across sportsbooks on it. |
selection_line | string | null | over or under on a ladder, yes or no on a Yes/No future, null on an outright or a pair |
points | number | null | The line of a ladder (12.5). null on every row whose selection_line is not over or under. |
is_main | boolean | true on a sportsbook’s main line of a ladder, false on its other lines. Always true on a row that is not on a ladder. See below. |
price | integer | American odds: 900 is +900, -130 is -130. Derive decimal odds and implied probability from it: see Odds Formats. |
team_id | string | null | The team’s id, the same id the odds endpoints use for teams (Entity reference IDs), when the selection is one team. null otherwise: a player, a pair, a coach, a division, a state, or a team SharpAPI cannot match. It is not always equal to normalized_selection: Arsenal FC is arsenal. |
Main linesPermalink for this section
A sportsbook can list several lines of one ladder for the same selection. is_main is true on exactly one line per sportsbook and selection: the line the sportsbook prices on both sides whose two prices are closest to even. When it prices no line on both sides, as FanDuel does above, it is the line whose price is closest to even, here 54.5 at +130. A line priced on both sides always beats a line priced on one side, and a tie goes to the lower line. is_main=true keeps those lines (and every row that is not on a ladder); is_main=false keeps the others.
Ordering and paginationPermalink for this section
Futures are ordered by league, then id. Rows within a future are ordered by normalized_selection, then sportsbook, then side (no side, over, under, yes, no), then points. Rows are not ordered by price: sort client-side.
limit and offset count futures, not rows. A page holds up to limit futures, each with all of its rows that match the filters.
| Field | Type | Description |
|---|---|---|
pagination.limit | integer | Futures per page, as applied |
pagination.offset | integer | Futures skipped before this page |
pagination.count | integer | Futures on this page. Same as meta.count. |
pagination.total | integer | Futures that match the filters, before paging. Same as meta.total. |
pagination.has_more | boolean | Whether another page follows |
pagination.next_offset | integer | null | The offset of the next page, or null on the last page |
meta.count | integer | Futures in data |
meta.total | integer | Futures that match the filters, before paging |
meta.odds_count | integer | Rows in data, across its futures |
meta.updated_at | string | When the futures data in this response was read (RFC 3339), not when the response was sent. Consecutive requests can return the same value. |
The envelope of the fourth request, the second page of NBA futures at two per page. 19 futures match; the two on this page hold 13 and 15 rows, so meta.odds_count is 28.
{
"success": true,
"data": [ ... ],
"pagination": {
"limit": 2,
"offset": 2,
"count": 2,
"total": 19,
"has_more": true,
"next_offset": 4
},
"meta": {
"count": 2,
"total": 19,
"odds_count": 28,
"updated_at": "2026-10-26T12:41:24.754966665Z"
}
}ErrorsPermalink for this section
| Status | Code | When |
|---|---|---|
400 | validation_error | /futures/odds was called with neither future_id nor league |
401 | missing_api_key, invalid_api_key | No API key, or an invalid one |
403 | tier_restricted | The key’s tier is below Enterprise |
429 | rate_limited | Rate limit exceeded |
503 | service_unavailable | Futures data is temporarily unavailable: no copy newer than 5 minutes could be read. Retry later; the Retry-After header gives the seconds to wait. |
{
"error": {
"code": "validation_error",
"message": "Missing required parameter: future_id or league"
}
}A filter that matches no future is not an error: the response is 200 with an empty data.
Migrating from the previous response shapePermalink for this section
Both endpoints keep their paths and return the shape described above. The previous shape is no longer served, and no parameter brings it back.
A future_id from the previous shape (championship_winner) matches nothing now: the response is 200 with an empty data. Take the new ids from GET /api/v1/futures. future_type=OVER_UNDER and future_type=YES_NO return an empty data too: the future types are TEAM, PLAYER and UNKNOWN, and the side of a row is its selection_line.
GET /api/v1/futures
| Previous | Now |
|---|---|
market_id (championship_winner) | id (nba__championship_winner): the values changed |
display_name (NBA Championship Winner) | name (Championship Winner) |
future_type: TEAM, PLAYER, OVER_UNDER, YES_NO | future_type: TEAM, PLAYER, UNKNOWN |
sport, league, selection_count, books_available | Kept |
| - | odds_count |
| - | start_date |
| - | future_id query parameter |
GET /api/v1/futures/odds
| Previous | Now |
|---|---|
| A flat list of rows, paged by row, 100 rows by default | A list of futures, each with an odds array, paged by future, 50 futures by default |
future_id required | future_id or league required |
selection | selection, and normalized_selection to join on |
sportsbook | sportsbook |
odds_american | price |
odds_decimal, probability | Removed: derive them from price |
line | points, with the side in selection_line (over, under, yes, no) |
future_market_id, future_market_name, future_type, sport, league on every row | id, name, future_type, sport, league on the future that holds the rows |
event_start_time on every row | start_date on the future that holds the rows: the earliest start among the sportsbooks asked for |
meta.future_id, meta.books_count, meta.selections_count | Removed |
| - | id, market, name, is_main, team_id on every row |
| - | future_type, team_id, selection, is_main query parameters |
RelatedPermalink for this section
- MCP Server - the
get_futures,get_futures_oddsandcompare_futures_linestools read these endpoints - Leagues - the league ids to pass as
league - Odds Formats - American, decimal and implied probability