SureBet APIsurebet.com ↗
Access real-time surebets, middles, and valuebets from SureBet.com. Filter by profit %, sort by ROI, and retrieve full bookmaker and sport metadata.
What is the SureBet API?
This API exposes 5 endpoints covering SureBet.com's core betting opportunity data: arbitrage surebets, middles, and valuebets, plus reference data for bookmakers and sports. The get_surebets endpoint returns paginated arbitrage opportunities with per-leg prong details, profit percentages, and ROI figures. Filters for minimum and maximum profit let you target specific thresholds, and results can be sorted by profit, creation time, start time, or ROI.
curl -X GET 'https://api.parse.bot/scraper/4302d8bc-f259-487f-8b4d-4a05ef9a24d1/get_surebets?page=1&order=profit&max_profit=5.0&min_profit=0.1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace surebet-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: SureBet SDK — arbitrage, valuebets, middles, and reference data."""
from parse_apis.surebet_api import SureBet, SurebetOrder, PageNotFound
client = SureBet()
# List surebets sorted by profit, capped at 3 items
for surebet in client.surebets.list(order=SurebetOrder.PROFIT, min_profit=0.5, limit=3):
print(f"Profit: {surebet.profit}% | ROI: {surebet.roi}% | Legs: {len(surebet.prongs)}")
# Drill into one middle opportunity
middle = client.middles.list(limit=1).first()
if middle:
print(f"Middle EV: {middle.ev} | Bet: {middle.bet} | Win: {middle.win} | P: {middle.probability}")
# List valuebets
valuebet = client.valuebets.list(limit=1).first()
if valuebet:
print(f"Valuebet legs: {len(valuebet.prongs)}")
# Load reference data: bookmakers and sports
for bm in client.bookmakers.list(limit=5):
print(f"Bookmaker: {bm.name} (id={bm.id}, disabled={bm.disabled})")
# Typed error handling on sports list
try:
for sport in client.sports.list(limit=5):
print(f"Sport: {sport.name} (ref={sport.ref})")
except PageNotFound as exc:
print(f"Page not found: {exc}")
print("exercised: surebets.list / middles.list / valuebets.list / bookmakers.list / sports.list")
Fetch surebets (arbitrage opportunities) with optional profit filters and sort order. Returns paginated results. Each surebet contains prongs (JSON-encoded leg details with bookmaker, odds, teams, tournament), profit percentage, and ROI. Paginates via integer page parameter. Note: Profit > 1% typically requires a paid account on the source site.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| order | string | Sort order for results. |
| max_profit | number | Maximum profit percentage filter (e.g. 2.0 for 2%). |
| min_profit | number | Minimum profit percentage filter (e.g. 0.5 for 0.5%). |
{
"type": "object",
"fields": {
"page": "integer page number",
"items": "array of surebet opportunity objects, each containing prongs (array of JSON-encoded leg details), profit, and roi"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"roi": 121.38,
"profit": 1,
"prongs": [
"{\"id\":178437569,\"tournament\":\"World - World Cup 2026\",\"teams\":[\"Australia\",\"Turkey\"],\"value\":1.37,\"bk\":\"pin_up\",\"sport_id\":15}",
"{\"id\":192650779,\"tournament\":\"International - FIFA World Cup\",\"teams\":[\"Australia\",\"Turkey\"],\"value\":2.75,\"bk\":\"cloudbet\",\"sport_id\":15}"
],
"top_synonym_id": null
}
]
},
"status": "success"
}
}About the SureBet API
Arbitrage and Opportunity Endpoints
The get_surebets endpoint returns paginated surebet objects, each containing a prongs array of JSON-encoded leg details alongside profit and roi fields. You can narrow results using min_profit and max_profit parameters (expressed as percentages, e.g. 0.5 for 0.5%) and control sort order via the order parameter, which accepts profit, created_at, start_at, or roi. Note that opportunities with profit above 1% are only accessible with a paid account.
The get_middles endpoint surfaces overlapping-bet opportunities. Each middle object includes prongs for the individual legs plus ev (expected value), bet, probability, win, and be (break-even) fields, giving you the full statistical picture of each middle. The get_valuebets endpoint returns overvalued-bet opportunities in a similar paginated format, with prongs detail per item. Both endpoints accept a page parameter for pagination.
Reference / Metadata Endpoints
get_bookmakers returns the full list of bookmakers supported on SureBet.com. Each bookmaker object includes name, id, ref, link, and three status flags: disabled, checked, and temporary_disabled. These flags let you identify which bookmakers are currently active before building filtering logic in your application.
get_sports returns a list of all covered sports, each with a name, id, and ref. Use these IDs as stable references when you need to cross-reference sport coverage against opportunities returned by the betting endpoints.
The SureBet API is a managed, monitored endpoint for surebet.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when surebet.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official surebet.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen surebets in real time by filtering
min_profitandmax_profitto surface only actionable arbitrage windows. - Build a ROI-ranked dashboard by querying
get_surebetswithorder=roiand displaying top opportunities. - Calculate expected value for middles trading using the
ev,probability, andbefields fromget_middles. - Monitor bookmaker availability by polling
get_bookmakersfor changes indisabledortemporary_disabledstatus flags. - Map sport coverage to internal IDs by consuming
get_sportsand usingrefvalues for consistent cross-endpoint referencing. - Build a valuebet tracker that pages through
get_valuebetsresults and logs prong-level odds changes over time. - Cross-reference active bookmakers against middle opportunities to filter out legs involving currently disabled bookmakers.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SureBet.com have an official developer API?+
How does profit filtering work on the get_surebets endpoint?+
min_profit and max_profit as numeric parameters representing percentage values (e.g., 1.0 equals 1%). Results with profit above 1% require a paid account; free-tier requests will not return those opportunities regardless of the filter values set.What statistical fields does get_middles return that get_surebets does not?+
get_middles returns ev (expected value), probability, win, and be (break-even) per opportunity in addition to the prongs array, making it richer for statistical analysis. get_surebets focuses on profit and roi without those probabilistic fields.Can I filter surebets or valuebets by a specific sport or bookmaker?+
get_sports and get_bookmakers and apply filtering client-side. You can also fork this API on Parse and revise it to add server-side sport or bookmaker filtering if needed.Is historical surebet data available through this API?+
order=created_at and order=start_at sort options affect result ordering but do not extend coverage to past events. You can fork this API on Parse and revise it to add an archival or time-range endpoint if your use case requires historical records.