Skip to Content
API ReferenceDeep Links

Deep Links

Generate sportsbook deep links from odds IDs or opportunity hash IDs. Deep links take users directly to the relevant event page on a sportsbook’s website, enabling one-click bet placement from your application.

EndpointsPermalink for this section

MethodPathDescription
POST/api/v1/deeplinks/batchGet deep links for up to 500 IDs
GET/api/v1/deeplink/{id}Redirect to a sportsbook (public; without an API key it is rate limited)

AuthenticationPermalink for this section

Requires API key for POST /deeplinks/batch. Available to Hobby tier and above.

The redirect endpoint (GET /deeplink/{id}) is public and does not require authentication — the opaque ID prevents enumeration. A request without an API key is rate limited, so a program that opens many links must send its key.

The id parameter accepts both odds IDs (from /odds, /odds/best) and opportunity hash IDs (from +EV, Arbitrage, Middles, and Low Hold endpoints). Either ID type resolves to the most specific link that sportsbook supports — specificity is a property of the book, not of the ID type. Read X-Deep-Link-Type on the redirect to see what you got, and see Supported Sportsbooks for which books preselect the bet.


POST /api/v1/deeplinks/batch

Returns deep link redirect paths for multiple IDs in a single request. Accepts both odds IDs and opportunity hash IDs. Each ID in the request appears in the response — resolved IDs return a redirect path, unresolvable IDs return null.

Request BodyPermalink for this section

{ "ids": ["17336125542407", "77b0749a1faae425", "abc1234567890def"], "state": "nj" }
FieldTypeDefaultDescription
idsstring[]requiredArray of odds IDs or opportunity hash IDs (1–500 items)
statestringpaUS state code for deep-link routing only; does not filter odds or return state-specific prices. Uses the 50 US state codes plus dc; omitted, empty, or unsupported values (including on) fall back to pa in this batch endpoint. The single-link redirect rejects unsupported nonempty codes instead.

Example RequestsPermalink for this section

curl -X POST "https://api.sharpapi.io/api/v1/deeplinks/batch" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ids": ["17336125542407", "77b0749a1faae425"], "state": "nj"}'

ResponsePermalink for this section

Success (200)Permalink for this section

The batch endpoint returns redirect paths, not direct sportsbook URLs. Prepend your base URL or use the path with the redirect endpoint to reach the sportsbook.

{ "data": { "17336125542407": "/api/v1/deeplink/17336125542407", "77b0749a1faae425": "/api/v1/deeplink/77b0749a1faae425", "abc1234567890def": null }, "updated_at": "2026-02-11T12:00:15.000Z" }
ValueMeaning
"/api/v1/deeplink/{id}"Deeplink available — follow the redirect path to reach the sportsbook
nullNo deeplink available for this ID (unsupported sportsbook, expired odds, or invalid ID)

To get the final sportsbook URL, either follow the redirect (GET https://api.sharpapi.io/api/v1/deeplink/{id}) or use the path directly in <a href> links — the browser will follow the 302 redirect automatically. A program that follows many redirects without an API key is rate limited.

Error ResponsesPermalink for this section

400 Missing IDs

{ "error": { "code": "validation_error", "message": "ids array required" } }

400 Batch size exceeded

{ "error": { "code": "validation_error", "message": "Maximum 500 IDs per batch" } }

GET /api/v1/deeplink/{id}

Redirects the user directly to the sportsbook page for a given odds ID or opportunity hash ID. This is a public endpoint — it works without an API key, but a request without one is rate limited.

Use this endpoint in <a href> links to send users directly to a sportsbook. The response is a 302 Found redirect, not JSON.

Path ParametersPermalink for this section

ParameterTypeDescription
idstringRequired. Either a numeric odds ID (e.g., 135102220304350) or an opportunity hash ID (16-char hex, e.g., 77b0749a1faae425)

Query ParametersPermalink for this section

ParameterTypeDefaultDescription
statestringpaUS state code for deep-link routing only; does not filter odds or return state-specific prices. Accepts the 50 US state codes plus dc. Unsupported nonempty codes (including on) return 400 invalid_filter. Omitted or empty values use pa.
bookstring—Sportsbook filter (for multi-book opportunities like middles/arbitrage)
fallbackstring—URL to redirect to if the ID is not found. Honoured only for an absolute http or https URL, with no port or user info, on sharpapi.io, sharplines.io or the website of a sportsbook the endpoint recognises (for example https://sportsbook.draftkings.com/); subdomains count. Any other value is ignored: a found ID redirects as usual, and an ID that is not found returns 404 not_found.

ExamplePermalink for this section

<!-- In your application HTML --> <a href="https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj&book=draftkings"> Bet on DraftKings </a>

ResponsePermalink for this section

Success (302 Found)Permalink for this section

HTTP/1.1 302 Found Location: https://sportsbook.draftkings.com/event/12345?outcomes=abc123 Cache-Control: private, max-age=60 X-Deep-Link-Type: outcome

The X-Deep-Link-Type header indicates the link specificity:

ValueDescription
outcomeDirect link to a specific bet selection (with selection ID)
eventLink to the event page (no specific selection)
homepageFallback to the sportsbook homepage

Error ResponsesPermalink for this section

404 Not found

{ "error": { "code": "not_found", "message": "Deep link ID not found" } }

If the fallback query parameter is an accepted URL (see the parameter table above) and the ID is not found, the endpoint redirects to it instead of returning a 404 JSON response. A fallback the endpoint does not accept is ignored, and the 404 above is returned.


Rate Limit Without an API KeyPermalink for this section

The redirect stays public, but every request to api.sharpapi.io that carries no API key is limited per client address: 12 requests a minute, with a burst allowance of 5. IPv6 clients are counted per /64 network. The bet-link redirect is held to this limit like any other keyless request. A request that carries an API key is not held to this no-key limit.

Over the limit, the answer is 429 with a Retry-After: 10 header (seconds):

{ "error": { "code": "rate_limited", "message": "Too many unauthenticated requests. Get a free API key at sharpapi.io", "retryAfter": 10 } }

What to do:

  • A person clicking links in a browser stays far below the limit. Nothing to do: keep the links in your web page keyless.
  • A program that follows redirects in bulk (for example to resolve final sportsbook addresses on a server) must send its API key, spread its requests out, and cache what it resolved. The batch endpoint above returns redirect paths, not final sportsbook addresses, so it does not remove the redirect step.
  • Never put an API key in a link shown to your own users. An <a href> carrying api_key= hands your key to every visitor.

Send the key in the X-API-Key header (recommended), in an Authorization: Bearer header, or as the api_key query parameter. See Authentication for all three. A server-side request resolving a link:

curl -i -H "X-API-Key: YOUR_API_KEY" \ "https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj"

When an ID answers 404 not_found, retrying the same ID does not help. Fresh rows carry fresh links.


Batch ResponsePermalink for this section

FieldTypeDescription
dataobjectMap of ID to redirect path (string) or null if unavailable
updated_atstringISO 8601 timestamp of the odds data

Supported SportsbooksPermalink for this section

Deep link support is per sportsbook, and so is link specificity. Whether a link opens the event page or opens the bet slip with your selection already on it is decided by what that sportsbook’s own site accepts — not by which ID type you sent. The X-Deep-Link-Type header on the redirect tells you which one you got, per link.

Measured against production on 2026-08-25, across every sportsbook the API was serving at the time — 26 of 35 resolve a deep link, and 12 of those preselect the bet:

SportsbookDeep linkPreselects your selectionState-specific
BallyBetYesYesNo
BetMGMYesYesYes
betPARXYesYesNo
BetRiversYesYesYes
BetwayYesYesNo
BovadaYesYesNo
bwinYesYesNo
CaesarsYesYesYes
DraftKingsYesYesNo
FanDuelYesYesNo
Hard RockYesYesNo
UnibetYesYesNo
1xBetYesNoNo
BetanoYesNoNo
BetOnlineYesNoNo
KalshiYesNoNo
LadbrokesYesNoNo
NovigYesNoNo
PinnacleYesNoNo
PolymarketYesNoNo
ProphetXYesNoNo
SportzinoYesNoNo
StakeYesNoNo
Rebet †App linkNoNo
SBOBET ‡PartialNoNo
SX Bet ‡PartialNoNo
Betfair ExchangeNo——
CircaNo——
FanaticsNo——
FliffNo——
GoldrushNo——
SABANo——
SkyBetNo——
theScore BetNo——
UnderdogNo——

† Rebet resolves to a mobile app link (com.rebet.app://…). On desktop the redirect endpoint uses your fallback URL instead, if it accepts that URL, and reports X-Deep-Link-Type: homepage.

‡ SBOBET and SX Bet resolve to a sport or league page rather than the individual event.

Polymarket deep links resolve to the global polymarket.com  venue, not PolymarketUS.

IDs for a sportsbook in the No group return null in the batch response, and the redirect endpoint returns 404 unless you pass a fallback it accepts. Even on a supported sportsbook an individual ID can return null — not every market has a page. A sportsbook that was not publishing odds when this was measured is not listed.

Pinnacle deep links cannot preselect a bet. Pinnacle’s link is a matchup page (https://www.pinnacle.com/en/all-sports/matchup/{id}) and has no selection parameter to carry your outcome, so it is event-level whether you send a numeric odds ID or an opportunity hash ID. The bettor picks the outcome on the page.

  • +EV Opportunities - Source of hash_id values for +EV bets
  • Arbitrage - Source of hash_id values for arbitrage opportunities
  • Middles - Source of hash_id values for middle opportunities
  • Low Hold - Source of hash_id values for low-hold opportunities
Last updated on