FAQ

Getting Started

What products does SharpSports offer?

  • BetSync for linking sportsbook accounts and pulling bets
  • BetPlace for sportsbook deeplinks with a bet pre-loaded
  • BetPrices for live odds across sportsbooks
  • historicData for historic odds and line movement and player and team historic statistical data

What is BetSync?

BetSync links an end user's sportsbook account and pulls their bets into your application. See the BetSync overview and BetSync quickstart.

What is BetPlace?

BetPlace generates links or deeplinks that send a user to a sportsbook with a bet pre-loaded. See the BetPlace Overview.

What is included in BetPlace?

BetPlace support varies by book. For most books we provide links that send an end user to a filled-out betslip, while others only support sending the user to the event page for the relevant bet. Different books are also available on different platforms — one or more of desktop, iOS and Android.

The betPlaceStatus field on the 📖 Book object shows the BetPlace support for each platform. You can fetch this information for all books using the 📜 book list endpoint.

For a detailed breakdown of market coverage by book, see the BetPrices settings in the SharpSports dashboard. You must create a sandbox account and log in to the dashboard to see this breakdown.

What is BetPrices?

BetPrices provides live odds across sportsbooks. See the BetPrices quickstart.

What is historicData?

historicData provides historic odds and line movement. See the historicData quickstart and Historic Odds.

What environments are available?

Each SharpSports account has two environments: Sandbox and Live. See Sandbox Environment for the differences between them.

Where can I find my API keys?

API keys are available in the API settings of the SharpSports dashboard. Sandbox and Live each have their own set of keys.

BetSync & Account Linking

How does sportsbook account linking work?

SharpSports provides a linking UI/SDK flow in which the end user selects their region and sportsbook and enters the required credentials. Once the account is connected, SharpSports assigns a unique identifier and sends the relevant webhook. See Linking Accounts.

Do I need to use the SharpSports SDK?

It depends on the sportsbook, but an SDK integration is required to access all of the sportsbooks that SharpSports offers. Some sportsbooks require the SharpSports SDK to run on the user's device for syncing and refreshes, while others support server-side refreshes.

The 📜 book list endpoint is the authoritative place to check current requirements. See also SDK Coverage, but this data may be stale if there have been recent changes.

Can sportsbooks be refreshed server-to-server (without the SDK)?

Yes, some sportsbooks can be refreshed server-to-server. If a book does not require the SDK, you can refresh from your own cloud environment using the 🔄 refresh bettorAccount or 🔄 refresh bettor endpoints. Because sportsbook capabilities can change, verify the current 📜 book list before implementing against a specific book.

Why do some sportsbooks require the SDK?

Some sportsbook connections require activity to occur on the user's device. For those books, the SDK is required and a backend-only refresh is not supported.

Can I use the API instead of the SDK for every refresh?

No. For SDK-required books, refreshes must use the SDK refresh method. Non-SDK books may support backend/API refreshes.

Does the user have to be in the app to refresh?

For SDK-required books (including DraftKings and FanDuel), yes: syncs happen on the user's device, so the user needs to be in the app for the refresh to complete. You will know the user can exit the app when you receive a refreshresponse.created webhook.

Can I customize the SharpSports linking UI?

You can customize light/dark mode and primary and secondary colors in the Whitelabel Settings section of the SharpSports dashboard. SharpSports also provides a management widget that lets bettors manage their synced accounts. If you'd rather build account management into your own UI, see Bettor Account Management.

Can refresh functionality be triggered from my native UI?

Yes. Refreshes can be triggered from your native UI; we recommend using the SDK refresh method. See Hosting a Refresh Button.

What is a CID/context ID?

A CID, or context ID, is an identifier used to create a single linking session. In a mobile application, use the SharpSports SDK Context method to create linking sessions for both SDK and non-SDK books. For a website, use the 🔄 betSync Context endpoint.

What is a Bettor?

A 👤 Bettor represents one end user of your application. Bettor IDs use the BTTR_ prefix.

What is a BettorAccount?

A 📱 BettorAccount represents one sportsbook account belonging to a Bettor. BettorAccount IDs use the BACT_ prefix.

Refreshes, Webhooks & 2FA

What is a RefreshResponse?

A 🔄 RefreshResponse represents the result of one refresh attempt for a single BettorAccount. Refresh results are visible in the dashboard and can also be retrieved through the API using the 📜 refreshResponse list endpoints.

How do I know whether a refresh is completed?

Check whether a RefreshResponse was created — you'll receive a refreshresponse.created webhook when it is. If no RefreshResponse appears, the refresh did not complete. This can point to an SDK or implementation issue, or to the refresh being interrupted by the user exiting the application.

How should I trigger a refresh?

For SDK-required books, use the SDK refresh method rather than calling the API refresh endpoint directly. For a desktop website using our Chrome browser extension integration, you can use the refresh endpoints, but you must follow the instructions in the browser extension docs.

Common UX patterns include refreshing when the user enters a relevant page or providing a manual Refresh button. See Refreshing Bets for best practices.

Can SharpSports automatically refresh sportsbook accounts?

Some non-SDK books support automated/server-side refreshes, including cadence refreshes configured in the dashboard. SDK-required books generally require the user/device flow, so automatic refresh behavior should be implemented on a per-book basis.

Even without a refresh, SharpSports can grade pending bets automatically using AutoGrade.

Can SharpSports grade bets without a refresh?

Yes. When the Auto-Grade setting is turned on in the BetSync settings of the dashboard, SharpSports grades open bets that match a closed bet with the same MarketSelection and line, and sends a refreshresponse.created webhook for a RefreshResponse with type = grade. Autograded bets are marked autoGrade = true until a later refresh confirms the result on the user's account. See AutoGrade for details.

AutoGrade should not be relied on by itself. Because it does not reflect the true state of a user's sportsbook account (for example, a bet that was cashed out), you still need to set up proper refresh mechanisms.

How frequently can I refresh an account?

SharpSports rate-limits refreshes to one refresh per minute per account (see Refresh Rate Limiting). However, if you are performing automated server-side refreshes, we recommend refreshing no more than once per hour per account to prevent accounts from becoming unlinked/unverified.

How long does a refresh take?

Refresh duration varies by sportsbook and the amount of betting history being processed. The first sync typically takes 10–60 seconds, but can take up to 2 minutes for accounts with very large bet histories. After the initial sync, refreshes typically take 10–30 seconds depending on the book.

Why might one sportsbook take longer to sync than another?

Timing varies based on how the sportsbook's API works and the size of the user's bet history. SharpSports also avoids pulling the full history on every refresh when it is not necessary.

How much betting history can SharpSports pull?

SharpSports pulls a maximum of 5,000 bets per refresh for users with very large histories. Per-book limits can also apply, including total-bet limits, lookback limits, or hard cutoff dates. Check the maxHistoryMonths, maxHistoryBets and historyDetail fields on the 📖 Book object for current book-specific limits.

Can I limit the history pulled during a refresh?

Yes. You can use the 📜 betSlips list endpoint with the RefreshResponse ID and a date range to limit the history retrieved when only a subset of bets is needed.

How does 2FA/OTP work?

2FA is generally driven by the end user's sportsbook account settings, although some books or regions may require it regardless of the user's settings. Some connections require periodic re-verification. Accounts that have Strong Authentication turned on require a 2FA code on every refresh.

See 2FA Handling for implementation details.

Can I tell whether a sportsbook will require 2FA?

The TFA field on the 📱 BettorAccount object indicates that the user has Strong Authentication turned on and will need to enter an OTP on the next refresh.

What happens if a connection needs to be reverified?

Check the latest RefreshResponse status code and the verified field on the 📱 BettorAccount. If the connection is no longer valid, the user will need to reconnect through the SharpSports UI. You can listen for the bettorAccount.unverified webhook to detect this — see Handling Webhooks.

Bet Data & Parsing

What is a betslip?

A 💰 BetSlip is an object that can contain multiple 📃 Bets, such as parlay legs. BetSlip IDs use the SLIP_ prefix and individual bets use the BET_ prefix.

What happens if SharpSports cannot fully parse a bet?

SharpSports uses standardized objects for parsed betting data. Typically SharpSports fully parses all bets that correspond to a SharpSports 📋 Market object. If a bet is incomplete, the bookDescription field can be used as a fallback — see Complete vs Incomplete Bets.

Incomplete bets that do correspond to a SharpSports Market object should be treated as an edge case and reported to SharpSports.

How are events, players and teams identified?

SharpSports provides standardized 🎟️ Event, ⛹️‍♂️ Player, 🎽 Team and 🏟️ League objects. Sportradar, SportsDataIO and OddsJam/OpticOdds IDs are available for supported entities, along with other third-party identifiers. See Utilize Pre-Built Data Mapping Integrations.

How are markets represented?

Markets are represented by three objects:

  • A 📋 Market is the general betting concept tied to a league (e.g. Player Prop Total Rushing Yards for NFL).
  • A 🛒 MarketOffer ties a Market to a specific event and player.
  • A 🏷️ MarketSelection includes a position representing the actual selection, such as Over/Under, a team name (for moneylines and spreads), or a player name (for future awards like MVP).

How are parlay legs handled?

A betslip can contain multiple bets or parlay legs. SharpSports processes the sportsbook data and exposes standardized 📃 Bet objects for each leg where the source data supports them.

What happens if a sportsbook changes how it represents a bet?

Sportsbooks can change their underlying representations. SharpSports maintains its parsing and standardized objects, but occasional incomplete cases can occur. If required information is missing, we recommend using the bookDescription field and reporting the case.

SharpSports often updates its parsing engine to handle new bet representations. If the parsing for a bet changes from incomplete to complete, we will send a webhook with the updated information.

Sportsbook Status & Troubleshooting

How can I tell whether a sportsbook is down?

The SharpSports dashboard shows BetSync status by book and region, including degraded states. You should also check your shared Slack channel, where SharpSports posts material integration status changes. Book and region status is also available via the 📜 book list and 📜 bookRegions list endpoints.

What happens when a sportsbook is fully down?

SharpSports may turn the affected book off for maintenance and notify customers through Slack.

What does a yellow status indicator mean?

Yellow is a caution/degraded state for a book or region. Check the dashboard and your customer Slack channel for context.

What should I do if a refresh returns a non-200 response?

Treat the 🔄 RefreshResponse and associated error information as the starting point. If the issue concerns a specific customer account, collect the account identifiers, sportsbook/region, platform, SDK version, environment and timestamp, and escalate through your customer Slack channel.

What information should I provide when reporting a technical issue?

  • internalId (when available)
  • BTTR_ / BACT_ IDs
  • BetSlip or Bet ID
  • requestId
  • Sportsbook and region
  • Platform and SDK version
  • Environment (Sandbox or Live)
  • Exact timestamp and timezone
  • The API request, if relevant
  • Screenshots or recordings
  • Whether the issue affects one user or many

BetPrices & historicData

Which leagues are covered by historicData?

Any league for which SharpSports has current odds also has historic odds. Because book and market coverage can change, check the current 📖 betPlace and betPrice Coverage documentation and the dashboard.

How far back does historicData go?

historicData includes significant historic player-prop coverage for major professional sports beginning with the 2024 seasons, with greater parity in 2025. Newer integrations such as prediction markets do not have historic data before calendar year 2026. Exact depth varies by league, sportsbook and market.

Which sportsbooks are included in historicData?

For 2024+ professional sports, coverage includes Underdog, PrizePicks, BetRivers, Caesars, FanDuel, Pinnacle, theScore, DraftKings and BetMGM. Kalshi and Polymarket are also included as of the start of 2026. Coverage varies by league and era, so check the current documentation for a specific request.

Are historical prices attributed to individual sportsbooks?

Yes. historicData contains prices attributed to the individual book rather than an aggregated/blended price.

Does historicData cover the full event schedule?

All games are covered; preseason is not guaranteed. Specific market/book coverage can still vary.

When does historical price collection begin?

Collection begins as soon as sportsbooks start publishing odds. For example, NFL history can begin well before game time.

Are live/in-play prices included?

Yes. Prices continue through pregame and in-play in the same prices array; there is no separate series reset at event start.

How are line movements represented?

The line is a field on each price record rather than a separate series key. A single MarketSelection prices array can therefore contain multiple entries with different line values, with a main flag identifying the standard/current line. See Historic Odds.

Are both sides of a market recorded?

Yes. All outcomes are recorded for a market, with time-synchronized quotes where applicable. If a side is unexpectedly missing, please report it.

How are historicData timestamps represented?

Timestamps are represented as windows with opening and closing times in ISO-format UTC. See the 📈 prices historic timeseries endpoint for exact schema details.

How are postponed games represented?

A postponed game is not included as the original event; its data is reassigned to the rescheduled game.

What identifiers are available in historicData?

Events, teams and players have SharpSports identifiers, and third-party identifiers are available for many entities. See the 🎟️ Event, 🎽 Team and ⛹️‍♂️ Player documentation for current crosswalks.

Billing, Subscriptions & Roadmap

How does billing work?

BetSync is billed in arrears based on usage — the number of accounts active during the previous month. BetPrices, BetPlace, BetContent and historicData are billed at a fixed monthly rate. See subscription pricing for current rates.

What happens when I deactivate an account?

Setting access=false (see ❌ remove access) removes the account from the currently active dashboard/billable count. Because billing is in arrears, accounts active during the current cycle are still charged for that cycle; the savings appear in the next cycle.

Can I subscribe or unsubscribe from products myself?

Yes. The dashboard allows you to subscribe and unsubscribe from products such as BetSync, BetPlace, BetContent and historicData.

Can SharpSports support a new sportsbook?

New sportsbook requests can be logged and added to our roadmap/request list.