Skip to Content
API ReferenceSportsbooks

Sportsbooks

Get a list of available sportsbooks and their current status, including which tier is required to access each book’s data.

EndpointsPermalink for this section

GET /api/v1/sportsbooks

Requires an API key. Available on all tiers (Free included). Unauthenticated requests return 401.

List All SportsbooksPermalink for this section

Example RequestsPermalink for this section

curl -X GET "https://api.sharpapi.io/api/v1/sportsbooks" \ -H "X-API-Key: YOUR_API_KEY"

ResponsePermalink for this section

Real response, truncated to 6 of the 68 books currently returned (has_limits, added September 2026, has been inserted into each row to show the current shape). Every entry carries the full field set, except that numerical_id is omitted on a book not yet mapped in the atlas:

{ "data": [ { "id": "draftkings", "display_name": "DraftKings", "short_name": "DraftKings", "numerical_id": 17, "category": "major_us", "is_sharp": false, "has_live_odds": true, "has_player_props": true, "has_limits": false, "regions": ["US"], "requires_tier": "free", "status": "active", "event_count": 457, "last_update": "2026-07-02T18:17:55.852268618Z", "coming_soon": false }, { "id": "fanduel", "display_name": "FanDuel", "short_name": "FanDuel", "numerical_id": 19, "category": "major_us", "is_sharp": false, "has_live_odds": true, "has_player_props": true, "has_limits": false, "regions": ["US"], "requires_tier": "free", "status": "active", "event_count": 494, "last_update": "2026-07-02T18:17:55.921509102Z", "coming_soon": false }, { "id": "bet365", "display_name": "bet365", "short_name": "bet365", "numerical_id": 4, "category": "regional", "is_sharp": false, "has_live_odds": true, "has_player_props": true, "has_limits": false, "regions": ["US"], "requires_tier": "hobby", "status": "active", "event_count": 35, "last_update": "2026-07-02T18:16:34.848726023Z", "coming_soon": false }, { "id": "polymarket", "display_name": "Polymarket", "short_name": "Polymarket", "numerical_id": 29, "category": "exchange", "is_sharp": false, "has_live_odds": false, "has_player_props": false, "has_limits": false, "regions": ["GLOBAL"], "requires_tier": "hobby", "status": "active", "event_count": 1040, "last_update": "2026-07-02T18:17:44.093204728Z", "coming_soon": false }, { "id": "saba", "display_name": "SABA", "short_name": "SABA", "numerical_id": 32, "category": "regional", "is_sharp": false, "has_live_odds": true, "has_player_props": true, "has_limits": false, "regions": ["GLOBAL"], "requires_tier": "pro", "status": "active", "event_count": 2930, "last_update": "2026-07-02T18:17:50.012487996Z", "coming_soon": false }, { "id": "pinnacle", "display_name": "Pinnacle", "short_name": "Pinnacle", "numerical_id": 28, "category": "sharp", "is_sharp": true, "has_live_odds": true, "has_player_props": true, "has_limits": true, "regions": ["GLOBAL"], "requires_tier": "sharp", "status": "active", "event_count": 740, "last_update": "2026-07-02T18:17:55.967604052Z", "coming_soon": false } ], "updated_at": "2026-07-02T18:17:55.590257979Z" }

Sportsbook Object SchemaPermalink for this section

FieldTypeDescription
idstringUnique identifier (use in API filters)
numerical_idintegerStable integer key (frozen, never reused; omitted when unmapped). New (May 2026) — additive, optional. See Entity reference IDs.
display_namestringHuman-readable name
short_namestringShort display name
categorystringBook category (e.g. major_us, regional, sharp)
has_live_oddsbooleanSupports live/in-play odds
has_player_propsbooleanSupports player prop markets
has_limitsboolean | nullPublishes per-selection bet limits (max_bet on odds rows). Derived from the book’s current snapshot — true, false, or null when no rows have been observed. New (September 2026); see below.
regionsstring[]Available regions: US, UK, EU, AU, GLOBAL
is_sharpbooleanWhether the book is considered a sharp/efficient market
statusstringactive or inactive
event_countintegerNumber of matches (games) the book has odds for right now. Futures markets are not counted. Changed (November 2026); see below.
last_updatestringISO 8601 timestamp of last data update
currently_servingbooleantrue when the book is backed by odds data the API is serving right now. false for a book not launched yet, an inactive book, or a selectable book with no data at the moment (see idle_reason). It does not say how long a book has been without data. New (October 2026).
idle_reasonstring | nullWhy a book with no data has none, when known. "no_demand": the book can be selected but is paused because no customer has it selected; selecting it starts it again. "feed_gap": at least one customer has the book selected and it still has no data, because it is starting up after being selected or its data feed is interrupted; these rows are also listed in the default response. "paused": SharpAPI has temporarily switched the book off; the row has status: "inactive", there is no resume date, and it is not an outage (see Paused books). null in every other case; do not read it as a fault. More values may be added; treat a value you do not recognise as null. New (October 2026).
outageobject | nullOnly on a row with idle_reason: "feed_gap", and only when SharpAPI has evidence of when the data stopped. null on every other row, so a paused row never carries an outage. See The outage block. New (October 2026).
is_pickembooleantrue for a daily fantasy pick’em product (for example prizepicks or underdog): its entries are not bets placed at the quoted price, so keep these books apart from sportsbooks when comparing prices. false on every other book. On every row since November 2026.
pricing_modelstringWhich side of the market the prices are for. "back" on an ordinary book: the price to bet on the selection. "lay" on an exchange’s lay side: the price to bet against it, which cannot be compared with back prices. Read any value other than "back" as “not back prices”. On every row since November 2026.
requires_tierstringMinimum tier required: free, hobby, pro, or sharp (string; never null)
coming_soonbooleantrue for announced books not yet live

Changed (September 2026): two has_player_props declarations corrected. has_player_props is true when a book is declared to support player props or is currently serving player_* markets. fliff: true → false — Fliff prices moneyline, spread and totals only and has never emitted a player-prop market. prophetx: false → true — ProphetX emits player props on every active day on record, so it already read true whenever it was active; it now reads true during quiet windows too. If you filter books on has_player_props, fliff leaves your book set and prophetx is always in it. The Props column in the per-book tables below is regenerated from the live response and reflects the correction from its next regeneration.

Changed (November 2026): event_count counts matches only. It used to count every event a book had odds for, futures markets included. It now counts matches (games) only: a futures market, such as a championship winner, is not counted, so a book that prices futures shows a lower count than before. Futures and their odds are on the futures endpoints (Enterprise).

The event_count may be 0 and last_update may be null if a sportsbook is temporarily unavailable or experiencing data delays. event_count is also 0 for a book that has odds only for futures right now.

New (May 2026): numerical_idPermalink for this section

numerical_id is a frozen, dense-from-1 integer assigned per sportsbook in the SharpAPI atlas. It’s stable across rebrands and slug renames — pinnacle is numerical_id: 28 regardless of any future display-name changes.

  • Frozen: never reused or remapped.
  • Optional: omitted for sportsbooks not yet mapped (e.g. brand-new books in the catalog before assignment); slug id is always present.
  • Domain-scoped: unique across sportsbooks only.

Every odds row and opportunity leg also carries a matching sportsbook_ref block ({id, label, numerical_id}). See Entity reference IDs.

Paused booksPermalink for this section

idle_reason: "paused" marks a book that SharpAPI has temporarily switched off. The row is listed in the default response with status: "inactive", currently_serving: false, event_count: 0 and last_update: null. It is not an outage, it never carries an outage block, and there is no resume date.

{ "id": "examplebook", "display_name": "Example Book", "status": "inactive", "event_count": 0, "last_update": null, "currently_serving": false, "idle_reason": "paused" }

What to do with a paused book: treat it like any other book that is not serving. Do not poll for it and do not retry requests for it; use your other books meanwhile, and read /sportsbooks again when you next refresh your book list. The set of idle_reason values is open: handle a value you do not recognise as null.

A request that names only paused books (for example GET /api/v1/odds?sportsbook=examplebook), from a key that has them in its dashboard selection and on its plan, answers 503 with the code book_unavailable, details.idle_reason: "paused" and no Retry-After header. The message says the books are paused, that this is not an upstream outage, that there is no resume date, and that you can omit sportsbook= to query your other books:

{ "error": { "code": "book_unavailable", "message": "the requested sportsbook(s) are paused: they are in your dashboard selection and on your enterprise plan, but SharpAPI has temporarily switched them off. This is not an upstream outage. There is no resume date — do not poll for it. Omit sportsbook= to query your other books meanwhile.", "details": { "field": "sportsbook", "requested": ["examplebook"], "selected": ["examplebook", "pinnacle"], "tier": "enterprise", "idle_reason": "paused" } } }

This 503 carries no details.outage. A book that is not in your dashboard selection still answers 403 book_not_selected. Branch on error.code and details.idle_reason, not on the message text.

The outage blockPermalink for this section

A feed_gap row can carry an outage object that says how long the book has had no data. It uses the same field names as details.outage on the 503 book_unavailable response. Every other row has outage: null.

FieldTypeMeaningExample
extendedbooleantrue once the book has been unobserved for at least threshold_hours; false for a fresh gaptrue
unobserved_sincestringUTC time (RFC 3339) from which SharpAPI has seen no data for the book. For a book that has never had data, the time SharpAPI started watching it"2026-11-12T19:42:14Z"
threshold_hoursintegerHours without data after which extended becomes true24
{ "id": "otherbook", "status": "active", "event_count": 0, "currently_serving": false, "idle_reason": "feed_gap", "outage": { "extended": true, "unobserved_since": "2026-11-12T19:42:14Z", "threshold_hours": 24 } }

The key is omitted when there is no evidence, so do not require it. On the 503 the block appears only when extended is true, and unobserved_since is an object keyed by book there.

New (September 2026): has_limitsPermalink for this section

has_limits reports whether a sportsbook publishes per-selection bet limits — the max_bet field on odds rows. Only a small minority of books do (11 of 68 at the time of writing), and on every other book max_bet is simply absent from the row, which looks identical to a selection that happens to carry no limit. has_limits is the per-book answer to “is this absence a missing capability or a missing value?”

ValueMeaning
trueAt least one row in the book’s current snapshot carries max_bet
falseRows were observed and none carry max_bet — a real negative finding
nullNo rows observed, so no claim is made — rows with coming_soon: true and books that currently have zero rows
  • Derived, not declared. Unlike has_live_odds and has_player_props, which combine observed data with a per-book configuration entry, has_limits is computed from the odds SharpAPI is serving right now and nothing else. When a book starts or stops publishing limits, the flag follows on its own — the set of limit-publishing books does change, so read the flag rather than caching a list of books.
  • Any row, not every row. true means the book publishes limits somewhere in its current snapshot; individual rows can still omit max_bet. Treat it as “worth reading max_bet on this book”, not as a guarantee on every selection.
  • Always present; null is not false. The key is on every row. Guard the three states explicitly — a client that treats null as “no limits” re-creates the ambiguity the field exists to remove.
  • Same freshness as last_update. Both are recomputed in the same pass, so has_limits lags the true book state by the same amount: at most about 40 seconds across the recompute, in-process response cache and HTTP cache layers, and typically 15 seconds or less.

See Liquidity and Limits for how to use max_bet once a book reports has_limits: true.

Book Access by TierPermalink for this section

The per-tier and per-category book tables below are regenerated from the live /sportsbooks response when the docs are updated (last regenerated 2026-07-02) and can lag the roster between updates. The authoritative, always-current list is the GET /api/v1/sportsbooks response itself — fetch it rather than relying on these tables.

The requires_tier field indicates the minimum subscription tier needed to access a sportsbook’s odds data through the API.

TierBooks AvailableIncluded Sportsbooks
Free2DraftKings, FanDuel
Hobby59+ 18Bet — temporarily unavailable, 888sport (Italy) — temporarily unavailable, Bally Bet, bet365, Betfred — temporarily unavailable, BetMGM, BetOnline, betPARX — temporarily unavailable, BetRivers, Betsson — temporarily unavailable, BetVictor — temporarily unavailable, Betway — temporarily unavailable, Bovada, bwin — temporarily unavailable, Caesars, Codere — temporarily unavailable, Coral — temporarily unavailable, DraftKings Pick6 (2 Pick), DraftKings Pick6 (3 Pick), DraftKings Pick6 (6 Pick), DraftKings Pick6 Multipliers, DraftKings Predictions, Fanatics, Fanatics Markets, Fliff, Gemini, GG Bet — temporarily unavailable, Goldrush — temporarily unavailable, Hard Rock, Kalshi, Ladbrokes — temporarily unavailable, Ladbrokes UK — temporarily unavailable, LowVig — temporarily unavailable, Matchbook — temporarily unavailable, Novig, Paddy Power, Polymarket, Polymarket US, PrizePicks — temporarily unavailable, PrizePicks Flex — temporarily unavailable, Rebet — temporarily unavailable, Robinhood, Sky Bet — temporarily unavailable, Smarkets, Smarkets (Lay), Sportzino — temporarily unavailable, Stake, SX Bet — temporarily unavailable, theScore Bet, Thrillzz — temporarily unavailable, Underdog Fantasy — temporarily unavailable, Underdog Fantasy Multipliers — temporarily unavailable, Underdog Predictions — temporarily unavailable, Unibet — temporarily unavailable, Unibet (Denmark) — temporarily unavailable, Unibet (Sweden) — temporarily unavailable, Unibet (UK) — temporarily unavailable
Pro60+ SABA
Sharp68Choose any 25, including sharp books like Pinnacle
Enterprise68All available sportsbooks

requires_tier is the book’s minimum tier class — it is not the only gate. Each tier also has a book-count cap (Free 2, Hobby 5, Pro 15, Sharp 25, Enterprise unlimited), and Free keys are additionally whitelisted to DraftKings + FanDuel only — so a Free key cannot access eighteenbet or sportingbet_br even though those books carry requires_tier: "free". See the tier comparison for the full matrix.

Pinnacle, Circa Sports, SBOBET, 1xBet, ProphetX, and both Betfair feeds (betfair and betfair_lay) require Sharp tier or higher. Pinnacle is a sharp book whose efficient lines are used as the reference for +EV calculations. Circa Sports is another known sharp book with deliberately tight lines and a focused prop menu. Requesting sharp book odds on Free, Hobby, or Pro tier will return a 403 tier_restricted error.

Understanding requires_tierPermalink for this section

ValueMeaning
"free"Available on all tiers, including Free
"hobby"Requires Hobby tier or higher
"pro"Requires Pro tier or higher
"sharp"Requires Sharp or Enterprise tier

Supported SportsbooksPermalink for this section

Read more about each book in the sportsbook directory on sharpapi.io .

Major US BooksPermalink for this section

IDNameLivePropsTier
draftkingsDraftKingsYesYesFree
fanduelFanDuelYesYesFree
ballybetBally BetYesYesHobby
bet365bet365YesYesHobby
betmgmBetMGMYesYesHobby
betonlineBetOnlineYesYesHobby
betparxbetPARX — temporarily unavailableYesYesHobby
betriversBetRiversYesYesHobby
bovadaBovadaYesYesHobby
caesarsCaesarsYesYesHobby
draftkings_pick2DraftKings Pick6 (2 Pick)NoYesHobby
draftkings_pick3DraftKings Pick6 (3 Pick)NoYesHobby
draftkings_pick6DraftKings Pick6 (6 Pick)NoYesHobby
draftkings_pick6_multipliersDraftKings Pick6 MultipliersNoYesHobby
draftkings_predictionsDraftKings PredictionsNoNoHobby
fanaticsFanaticsYesYesHobby
fanatics_marketsFanatics MarketsYesNoHobby
fliffFliffYesYesHobby
geminiGeminiYesYesHobby
hardrockHard RockYesYesHobby
lowvigLowVig — temporarily unavailableNoNoHobby
novigNovigYesYesHobby
polymarket_usPolymarket USNoNoHobby
prizepicksPrizePicks — temporarily unavailableYesYesHobby
prizepicks_flexPrizePicks Flex — temporarily unavailableNoNoHobby
rebetRebet — temporarily unavailableYesYesHobby
robinhoodRobinhoodYesYesHobby
sportzinoSportzino — temporarily unavailableYesNoHobby
thescorebettheScore BetYesYesHobby
thrillzzThrillzz — temporarily unavailableNoYesHobby
underdogUnderdog Fantasy — temporarily unavailableNoYesHobby
underdog_multipliersUnderdog Fantasy Multipliers — temporarily unavailableNoNoHobby
underdog_predictionsUnderdog Predictions — temporarily unavailableNoNoHobby
circa_stadiumCirca Sports (Stadium) — temporarily unavailableNoNoSharp

Sharp BooksPermalink for this section

IDNameLivePropsTier
onexbet1xBetYesNoSharp
circaCirca SportsNoYesSharp
pinnaclePinnacleYesYesSharp
sbobetSBOBETYesNoSharp

Reading Pinnacle timestamps. Each odds row carries a timestamp field — the time SharpAPI last refreshed that row through its pipeline (feed-freshness), which advances every ingest cycle even when Pinnacle holds the line steady. It is not when the price last moved; that is price_updated_at, which can read hours old on a line Pinnacle has not moved. See understanding the timestamp field for what “stale” actually means on their feed.

InternationalPermalink for this section

IDNameLivePropsTier
eighteenbet18Bet — temporarily unavailableYesNoHobby
sport888_it888sport (Italy) — temporarily unavailableYesYesHobby
betfredBetfred — temporarily unavailableYesNoHobby
betssonBetsson — temporarily unavailableYesYesHobby
betvictorBetVictor — temporarily unavailableYesNoHobby
betwayBetway — temporarily unavailableYesYesHobby
bwinbwin — temporarily unavailableYesYesHobby
codereCodere — temporarily unavailableYesNoHobby
coralCoral — temporarily unavailableYesYesHobby
ggbetGG Bet — temporarily unavailableYesNoHobby
goldrushGoldrush — temporarily unavailableYesNoHobby
ladbrokesLadbrokes — temporarily unavailableYesYesHobby
ladbrokes_ukLadbrokes UK — temporarily unavailableYesYesHobby
matchbookMatchbook — temporarily unavailableYesYesHobby
paddypowerPaddy PowerYesYesHobby
skybetSky Bet — temporarily unavailableYesNoHobby
smarketsSmarketsYesNoHobby
smarkets_laySmarkets (Lay)YesNoHobby
stakeStakeYesYesHobby
sx_betSX Bet — temporarily unavailableYesNoHobby
unibetUnibet — temporarily unavailableYesYesHobby
unibet_dkUnibet (Denmark) — temporarily unavailableYesYesHobby
unibet_seUnibet (Sweden) — temporarily unavailableYesYesHobby
unibet_ukUnibet (UK) — temporarily unavailableYesYesHobby
sabaSABAYesYesPro
betfair_layBetfair Exchange (Lay) — temporarily unavailableYesNoSharp

ExchangesPermalink for this section

IDNameLivePropsTier
betfairBetfair ExchangeYesYesSharp
prophetxProphetXYesYesSharp

An exchange’s two sides are two separate books. An exchange quotes two prices for every selection — the back price (bet for an outcome) and the lay price (bet against it). SharpAPI serves each side as its own book: betfair and smarkets are the back sides, betfair_lay and smarkets_lay the lay sides. A lay book requires the same tier as its back book: Sharp for both Betfair feeds, Hobby for both Smarkets feeds. Odds rows carry no side field, so the sportsbook ID is what tells you which side a price is; on GET /sportsbooks a lay book carries pricing_model: "lay" and a back book pricing_model: "back".

A lay price is not a better back price. Laying is taking the other end of someone’s bet: you keep their stake if the outcome does not happen, and you owe (odds − 1) × their stake if it does. A lay quote is therefore normally higher than the back quote on the same selection, so feeding a lay book to a model that assumes back odds makes the market look better priced than it is. Do not pool a lay book with back books. SharpAPI’s own /odds/best and its +EV, arbitrage, middles and low-hold results leave lay books out.

All four feeds carry the exchange’s size figures, in GBP and never converted — max_bet, best_bid_liquidity and size_currency. The Smarkets feeds also emit total_liquidity; the Betfair feeds do not — see Liquidity and limits. The full price-by-price order book is not included.

Prediction MarketsPermalink for this section

IDNameLivePropsTier
kalshiKalshiYesYesHobby
polymarketPolymarketYesYesHobby

Polymarket and Kalshi are prediction market platforms. Unlike traditional sportsbooks, they use binary outcome contracts priced between $0 and $1. SharpAPI normalizes contract prices into standard odds formats (American, decimal, implied probability) so you can compare them directly with sportsbook odds. Kalshi is CFTC-regulated. SharpAPI ingests the global polymarket.com  venue, not PolymarketUS.

Polymarket rows additionally carry a polymarket_resolution field reflecting the upstream UMA optimistic-oracle lifecycle (settled_normal / voided / disputed / proposed / unknown). See Polymarket Resolution for the per-value semantics and the upstream caveat that cancellation, participant withdrawal, and event-not-occurred all collapse to the single voided bucket.

Sharp vs Soft BooksPermalink for this section

Sharp BooksPermalink for this section

  • Lower vig (juice) — tighter margins mean better odds accuracy
  • Efficient lines — used as the reference for +EV and fair value calculations
  • Not available in all regions — Pinnacle is not licensed in the US
  • Examples: Pinnacle, Circa Sports, SBOBET, 1xBet

Soft BooksPermalink for this section

  • Higher vig — wider margins create more room for +EV opportunities
  • More promotions — bonuses, boosts, and free bets
  • Slower line movement — may lag behind sharp market moves
  • Where value is found — the gap between soft book odds and sharp reference creates +EV
  • Examples: DraftKings, FanDuel, BetMGM, Caesars

Sharp books like Pinnacle set efficient lines quickly. Soft books often lag behind, creating windows where their odds offer positive expected value compared to the sharp reference. This is the foundation of +EV betting strategy.

Building a live betting tool? DraftKings and FanDuel have has_live_odds: true but frequently suspend markets during scoring plays and key moments. See Live vs. Pre-Match for a full breakdown of book behavior during live play.

Last updated on