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
| Method | Path | Description |
|---|---|---|
POST | /api/v1/deeplinks/batch | Get 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.
Batch Deep LinksPermalink for this section
POST /api/v1/deeplinks/batchReturns 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"
}| Field | Type | Default | Description |
|---|---|---|---|
ids | string[] | required | Array of odds IDs or opportunity hash IDs (1–500 items) |
state | string | pa | US 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
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"
}| Value | Meaning |
|---|---|
"/api/v1/deeplink/{id}" | Deeplink available — follow the redirect path to reach the sportsbook |
null | No 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"
}
}Deep Link RedirectPermalink for this section
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
| Parameter | Type | Description |
|---|---|---|
id | string | Required. Either a numeric odds ID (e.g., 135102220304350) or an opportunity hash ID (16-char hex, e.g., 77b0749a1faae425) |
Query ParametersPermalink for this section
| Parameter | Type | Default | Description |
|---|---|---|---|
state | string | pa | US 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. |
book | string | — | Sportsbook filter (for multi-book opportunities like middles/arbitrage) |
fallback | string | — | 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: outcomeThe X-Deep-Link-Type header indicates the link specificity:
| Value | Description |
|---|---|
outcome | Direct link to a specific bet selection (with selection ID) |
event | Link to the event page (no specific selection) |
homepage | Fallback 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>carryingapi_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.
Deep Link SchemaPermalink for this section
Batch ResponsePermalink for this section
| Field | Type | Description |
|---|---|---|
data | object | Map of ID to redirect path (string) or null if unavailable |
updated_at | string | ISO 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:
| Sportsbook | Deep link | Preselects your selection | State-specific |
|---|---|---|---|
| BallyBet | Yes | Yes | No |
| BetMGM | Yes | Yes | Yes |
| betPARX | Yes | Yes | No |
| BetRivers | Yes | Yes | Yes |
| Betway | Yes | Yes | No |
| Bovada | Yes | Yes | No |
| bwin | Yes | Yes | No |
| Caesars | Yes | Yes | Yes |
| DraftKings | Yes | Yes | No |
| FanDuel | Yes | Yes | No |
| Hard Rock | Yes | Yes | No |
| Unibet | Yes | Yes | No |
| 1xBet | Yes | No | No |
| Betano | Yes | No | No |
| BetOnline | Yes | No | No |
| Kalshi | Yes | No | No |
| Ladbrokes | Yes | No | No |
| Novig | Yes | No | No |
| Pinnacle | Yes | No | No |
| Polymarket | Yes | No | No |
| ProphetX | Yes | No | No |
| Sportzino | Yes | No | No |
| Stake | Yes | No | No |
| Rebet † | App link | No | No |
| SBOBET ‡ | Partial | No | No |
| SX Bet ‡ | Partial | No | No |
| Betfair Exchange | No | — | — |
| Circa | No | — | — |
| Fanatics | No | — | — |
| Fliff | No | — | — |
| Goldrush | No | — | — |
| SABA | No | — | — |
| SkyBet | No | — | — |
| theScore Bet | No | — | — |
| Underdog | No | — | — |
† 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.
Related EndpointsPermalink for this section
- +EV Opportunities - Source of
hash_idvalues for +EV bets - Arbitrage - Source of
hash_idvalues for arbitrage opportunities - Middles - Source of
hash_idvalues for middle opportunities - Low Hold - Source of
hash_idvalues for low-hold opportunities