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/sportsbooksRequires 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
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
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier (use in API filters) |
numerical_id | integer | Stable integer key (frozen, never reused; omitted when unmapped). New (May 2026) — additive, optional. See Entity reference IDs. |
display_name | string | Human-readable name |
short_name | string | Short display name |
category | string | Book category (e.g. major_us, regional, sharp) |
has_live_odds | boolean | Supports live/in-play odds |
has_player_props | boolean | Supports player prop markets |
has_limits | boolean | null | Publishes 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. |
regions | string[] | Available regions: US, UK, EU, AU, GLOBAL |
is_sharp | boolean | Whether the book is considered a sharp/efficient market |
status | string | active or inactive |
event_count | integer | Number of matches (games) the book has odds for right now. Futures markets are not counted. Changed (November 2026); see below. |
last_update | string | ISO 8601 timestamp of last data update |
currently_serving | boolean | true 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_reason | string | null | Why 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). |
outage | object | null | Only 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_pickem | boolean | true 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_model | string | Which 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_tier | string | Minimum tier required: free, hobby, pro, or sharp (string; never null) |
coming_soon | boolean | true 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
idis 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.
| Field | Type | Meaning | Example |
|---|---|---|---|
extended | boolean | true once the book has been unobserved for at least threshold_hours; false for a fresh gap | true |
unobserved_since | string | UTC 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_hours | integer | Hours without data after which extended becomes true | 24 |
{
"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?”
| Value | Meaning |
|---|---|
true | At least one row in the book’s current snapshot carries max_bet |
false | Rows were observed and none carry max_bet — a real negative finding |
null | No 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_oddsandhas_player_props, which combine observed data with a per-book configuration entry,has_limitsis 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.
truemeans the book publishes limits somewhere in its current snapshot; individual rows can still omitmax_bet. Treat it as “worth readingmax_beton this book”, not as a guarantee on every selection. - Always present;
nullis notfalse. The key is on every row. Guard the three states explicitly — a client that treatsnullas “no limits” re-creates the ambiguity the field exists to remove. - Same freshness as
last_update. Both are recomputed in the same pass, sohas_limitslags 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.
| Tier | Books Available | Included Sportsbooks |
|---|---|---|
| Free | 2 | DraftKings, FanDuel |
| Hobby | 59 | + 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 |
| Pro | 60 | + SABA |
| Sharp | 68 | Choose any 25, including sharp books like Pinnacle |
| Enterprise | 68 | All 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
| Value | Meaning |
|---|---|
"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
| ID | Name | Live | Props | Tier |
|---|---|---|---|---|
draftkings | DraftKings | Yes | Yes | Free |
fanduel | FanDuel | Yes | Yes | Free |
ballybet | Bally Bet | Yes | Yes | Hobby |
bet365 | bet365 | Yes | Yes | Hobby |
betmgm | BetMGM | Yes | Yes | Hobby |
betonline | BetOnline | Yes | Yes | Hobby |
betparx | betPARX — temporarily unavailable | Yes | Yes | Hobby |
betrivers | BetRivers | Yes | Yes | Hobby |
bovada | Bovada | Yes | Yes | Hobby |
caesars | Caesars | Yes | Yes | Hobby |
draftkings_pick2 | DraftKings Pick6 (2 Pick) | No | Yes | Hobby |
draftkings_pick3 | DraftKings Pick6 (3 Pick) | No | Yes | Hobby |
draftkings_pick6 | DraftKings Pick6 (6 Pick) | No | Yes | Hobby |
draftkings_pick6_multipliers | DraftKings Pick6 Multipliers | No | Yes | Hobby |
draftkings_predictions | DraftKings Predictions | No | No | Hobby |
fanatics | Fanatics | Yes | Yes | Hobby |
fanatics_markets | Fanatics Markets | Yes | No | Hobby |
fliff | Fliff | Yes | Yes | Hobby |
gemini | Gemini | Yes | Yes | Hobby |
hardrock | Hard Rock | Yes | Yes | Hobby |
lowvig | LowVig — temporarily unavailable | No | No | Hobby |
novig | Novig | Yes | Yes | Hobby |
polymarket_us | Polymarket US | No | No | Hobby |
prizepicks | PrizePicks — temporarily unavailable | Yes | Yes | Hobby |
prizepicks_flex | PrizePicks Flex — temporarily unavailable | No | No | Hobby |
rebet | Rebet — temporarily unavailable | Yes | Yes | Hobby |
robinhood | Robinhood | Yes | Yes | Hobby |
sportzino | Sportzino — temporarily unavailable | Yes | No | Hobby |
thescorebet | theScore Bet | Yes | Yes | Hobby |
thrillzz | Thrillzz — temporarily unavailable | No | Yes | Hobby |
underdog | Underdog Fantasy — temporarily unavailable | No | Yes | Hobby |
underdog_multipliers | Underdog Fantasy Multipliers — temporarily unavailable | No | No | Hobby |
underdog_predictions | Underdog Predictions — temporarily unavailable | No | No | Hobby |
circa_stadium | Circa Sports (Stadium) — temporarily unavailable | No | No | Sharp |
Sharp BooksPermalink for this section
| ID | Name | Live | Props | Tier |
|---|---|---|---|---|
onexbet | 1xBet | Yes | No | Sharp |
circa | Circa Sports | No | Yes | Sharp |
pinnacle | Pinnacle | Yes | Yes | Sharp |
sbobet | SBOBET | Yes | No | Sharp |
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
| ID | Name | Live | Props | Tier |
|---|---|---|---|---|
eighteenbet | 18Bet — temporarily unavailable | Yes | No | Hobby |
sport888_it | 888sport (Italy) — temporarily unavailable | Yes | Yes | Hobby |
betfred | Betfred — temporarily unavailable | Yes | No | Hobby |
betsson | Betsson — temporarily unavailable | Yes | Yes | Hobby |
betvictor | BetVictor — temporarily unavailable | Yes | No | Hobby |
betway | Betway — temporarily unavailable | Yes | Yes | Hobby |
bwin | bwin — temporarily unavailable | Yes | Yes | Hobby |
codere | Codere — temporarily unavailable | Yes | No | Hobby |
coral | Coral — temporarily unavailable | Yes | Yes | Hobby |
ggbet | GG Bet — temporarily unavailable | Yes | No | Hobby |
goldrush | Goldrush — temporarily unavailable | Yes | No | Hobby |
ladbrokes | Ladbrokes — temporarily unavailable | Yes | Yes | Hobby |
ladbrokes_uk | Ladbrokes UK — temporarily unavailable | Yes | Yes | Hobby |
matchbook | Matchbook — temporarily unavailable | Yes | Yes | Hobby |
paddypower | Paddy Power | Yes | Yes | Hobby |
skybet | Sky Bet — temporarily unavailable | Yes | No | Hobby |
smarkets | Smarkets | Yes | No | Hobby |
smarkets_lay | Smarkets (Lay) | Yes | No | Hobby |
stake | Stake | Yes | Yes | Hobby |
sx_bet | SX Bet — temporarily unavailable | Yes | No | Hobby |
unibet | Unibet — temporarily unavailable | Yes | Yes | Hobby |
unibet_dk | Unibet (Denmark) — temporarily unavailable | Yes | Yes | Hobby |
unibet_se | Unibet (Sweden) — temporarily unavailable | Yes | Yes | Hobby |
unibet_uk | Unibet (UK) — temporarily unavailable | Yes | Yes | Hobby |
saba | SABA | Yes | Yes | Pro |
betfair_lay | Betfair Exchange (Lay) — temporarily unavailable | Yes | No | Sharp |
ExchangesPermalink for this section
| ID | Name | Live | Props | Tier |
|---|---|---|---|---|
betfair | Betfair Exchange | Yes | Yes | Sharp |
prophetx | ProphetX | Yes | Yes | Sharp |
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
| ID | Name | Live | Props | Tier |
|---|---|---|---|---|
kalshi | Kalshi | Yes | Yes | Hobby |
polymarket | Polymarket | Yes | Yes | Hobby |
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.
Related EndpointsPermalink for this section
- Odds Snapshot - Filter odds by sportsbook
- Best Odds - Best odds across all books with sharp reference
- Odds Comparison - Compare odds across books side by side
- Sports - List available sports