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

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"

const response = await fetch('https://api.sharpapi.io/api/v1/sportsbooks', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});
const { data } = await response.json();
 
// Filter for sharp books
const sharpBooks = data.filter(b => b.is_sharp);
console.log('Sharp books:', sharpBooks.map(b => b.display_name));
 
// Check which books require a higher tier
const proBooks = data.filter(b => b.requires_tier === 'pro');
console.log('Pro-tier books:', proBooks.map(b => b.display_name));

import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/sportsbooks',
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
result = response.json()
 
for book in result['data']:
    tier_note = f" (requires {book['requires_tier']})" if book['requires_tier'] else ""
    sharp_note = " [SHARP]" if book['is_sharp'] else ""
    print(f"{book['display_name']}{sharp_note}{tier_note}: {book['event_count']} events")

ResponsePermalink for this section

Real response, truncated to 6 of the 49 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; numerical_id is omitted on unmapped books (like Bet365 US below — also the only book ID with capitals and a space, kept in display-name form for historical reasons):

{
  "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 US",
      "display_name": "Bet365 US",
      "short_name": "Bet365 US",
      "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

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.

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 (12 of 49 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?”

• 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 requires_tier field indicates the minimum subscription tier needed to access a sportsbook’s odds data through the API.

Understanding requires_tierPermalink for this section

Supported SportsbooksPermalink for this section

Major US BooksPermalink for this section

Sharp BooksPermalink for this section

InternationalPermalink for this section

ExchangesPermalink for this section

Prediction MarketsPermalink for this section

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

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