Skip to Content
API ReferenceEnterprise Endpoints

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:

EndpointReturns
GET /api/v1/futuresThe futures: each with its id, its name and the sportsbooks that price it
GET /api/v1/futures/oddsThe 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_selection is that name in a form to join on.
  • Side and line. A row prices one side of a selection: over or under at a line on a win-total ladder, yes or no, or no side on an outright.
  • Future type. TEAM when the selections are teams, PLAYER when they are players, UNKNOWN when they are neither (a coach, a division, a state).

Row shapesPermalink for this section

Shapeselectionselection_linepointsExample future
OutrightThe team, player or other subject: Kansas City Chiefsnullnullnfl__super_bowl_winner
LadderThe team: Buffalo Billsover or underThe line: 12.5nfl__regular_season_wins
Yes/NoThe subject: Buffalo Billsyes or nonullnfl__to_make_the_playoffs
PairTwo subjects joined by ///: Arizona Cardinals /// Baltimore Ravensnullnullnfl__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:

Futurenameselection_lineprice
nfl__super_bowl_winnerKansas City Chiefsnull900
nfl__super_bowl_winner_yes_noKansas City Chiefs Yesyes900

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/futures

Query ParametersPermalink for this section

ParameterTypeDefaultDescription
sportstringallFilter by sport: one value, case-insensitive (football, basketball, soccer)
leaguestringallFilter by league: one value, case-insensitive, as /leagues lists it (nfl, nba, england_-_premier_league)
future_typestringallTEAM, PLAYER or UNKNOWN, case-insensitive. Any other value returns an empty data.
future_idstringallOne 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

FieldTypeDescription
idstringThe future’s id (nfl__super_bowl_winner). Pass it as future_id to /futures/odds.
namestringThe future’s name (Super Bowl Winner). A Yes/No twin ends in Yes/No.
future_typestringTEAM, PLAYER or UNKNOWN
sportstringSport (football)
leaguestringLeague id (nfl)
start_datestring | nullThe 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_availablearray of stringThe sportsbooks that price this future, sorted by name
selection_countintegerDistinct selections in the future
odds_countintegerRows 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/odds

Query ParametersPermalink for this section

ParameterTypeDefaultDescription
future_idstring-One future id, or several comma-separated. Required unless league is given.
leaguestring-Every future in one league: case-insensitive, as /leagues lists it (nfl). Required unless future_id is given.
sportstringallFilter by sport: one value, case-insensitive
future_typestringallTEAM, PLAYER or UNKNOWN, case-insensitive. Any other value returns an empty data.
sportsbookstringallOnly rows from these sportsbooks, comma-separated (fanduel,betmgm). books is accepted as an alias.
team_idstringallOnly rows on these teams, comma-separated team ids (kansas_city_chiefs). A row whose team_id is null never matches.
selectionstringallOnly 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_mainboolean-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.
limitinteger50Futures per page, from 1 to 200. A value outside that range (0, negative, above 200, not a number) becomes 50.
offsetinteger0Futures 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.

FieldTypeDescription
idstringThe 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.
sportsbookstringSportsbook id (betmgm)
marketstringThe future’s name, repeated on every row
namestringA 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)
selectionstringThe canonical name of the team or player, the same for every sportsbook (San Francisco 49ers). A pair is two names joined by ///.
normalized_selectionstringselection 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_linestring | nullover or under on a ladder, yes or no on a Yes/No future, null on an outright or a pair
pointsnumber | nullThe line of a ladder (12.5). null on every row whose selection_line is not over or under.
is_mainbooleantrue 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.
priceintegerAmerican odds: 900 is +900, -130 is -130. Derive decimal odds and implied probability from it: see Odds Formats.
team_idstring | nullThe 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.

FieldTypeDescription
pagination.limitintegerFutures per page, as applied
pagination.offsetintegerFutures skipped before this page
pagination.countintegerFutures on this page. Same as meta.count.
pagination.totalintegerFutures that match the filters, before paging. Same as meta.total.
pagination.has_morebooleanWhether another page follows
pagination.next_offsetinteger | nullThe offset of the next page, or null on the last page
meta.countintegerFutures in data
meta.totalintegerFutures that match the filters, before paging
meta.odds_countintegerRows in data, across its futures
meta.updated_atstringWhen 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

StatusCodeWhen
400validation_error/futures/odds was called with neither future_id nor league
401missing_api_key, invalid_api_keyNo API key, or an invalid one
403tier_restrictedThe key’s tier is below Enterprise
429rate_limitedRate limit exceeded
503service_unavailableFutures 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

PreviousNow
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_NOfuture_type: TEAM, PLAYER, UNKNOWN
sport, league, selection_count, books_availableKept
-odds_count
-start_date
-future_id query parameter

GET /api/v1/futures/odds

PreviousNow
A flat list of rows, paged by row, 100 rows by defaultA list of futures, each with an odds array, paged by future, 50 futures by default
future_id requiredfuture_id or league required
selectionselection, and normalized_selection to join on
sportsbooksportsbook
odds_americanprice
odds_decimal, probabilityRemoved: derive them from price
linepoints, with the side in selection_line (over, under, yes, no)
future_market_id, future_market_name, future_type, sport, league on every rowid, name, future_type, sport, league on the future that holds the rows
event_start_time on every rowstart_date on the future that holds the rows: the earliest start among the sportsbooks asked for
meta.future_id, meta.books_count, meta.selections_countRemoved
-id, market, name, is_main, team_id on every row
-future_type, team_id, selection, is_main query parameters
  • MCP Server - the get_futures, get_futures_odds and compare_futures_lines tools read these endpoints
  • Leagues - the league ids to pass as league
  • Odds Formats - American, decimal and implied probability
Last updated on