Oddsplug APIOddsplug.com ↗
Access real-time arbitrage betting opportunities from Oddsplug. Filter by sport and game type. Returns arb percentage, bookmakers, market, and tournament data.
What is the Oddsplug API?
The Oddsplug API exposes current arbitrage betting opportunities through a single fetch_arbitrages endpoint, returning up to 6 structured fields per opportunity including sport, tournament, market, bookmakers involved, and arbitrage percentage. You can filter results by sport or game type (prematch or live), making it straightforward to scan for mismatches across betting lines programmatically.
curl -X POST 'https://api.parse.bot/scraper/b18e2890-0c53-4b64-a103-511091e6d8f1/fetch_arbitrages' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"sport": "All",
"game_type": "prematch"
}'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 oddsplug-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: Oddsplug SDK — fetch arbitrage opportunities across sports."""
from parse_apis.oddsplug_com_api import Oddsplug, Sport, GameType, InvalidInput
client = Oddsplug()
# List all prematch arbitrage opportunities, capped at 5
for arb in client.arbitrages.list(sport=Sport.ALL, game_type=GameType.PREMATCH, limit=5):
print(arb.sport, arb.market_name, arb.arb_percentage)
for bm in arb.bookmakers:
print(f" {bm.bookmaker}: market={bm.market}, odd={bm.odd}")
# Filter to Football only
football_arb = client.arbitrages.list(sport=Sport.FOOTBALL, limit=1).first()
if football_arb:
print(f"Football arb: {football_arb.tournament} | {football_arb.market_name} | {football_arb.arb_percentage}%")
print(f" Starts: {football_arb.start_at_timestamp}, Created: {football_arb.created_at}")
# Handle invalid input gracefully
try:
for arb in client.arbitrages.list(sport=Sport.BASKETBALL, game_type=GameType.LIVE, limit=3):
print(arb.arb_id, arb.market_code)
except InvalidInput as exc:
print(f"Invalid input: {exc}")
print("exercised: arbitrages.list with sport/game_type filters, bookmaker field access")
Fetch current arbitrage betting opportunities. Returns a list of arbitrage opportunities showing the market, bookmakers involved, and the arbitrage percentage. Results can be filtered by sport and game type (prematch or live). Some fields (team names, odds) may be obscured for unauthenticated access.
| Param | Type | Description |
|---|---|---|
| sport | string | Sport to filter arbitrage opportunities by. |
| game_type | string | Type of game to filter by. |
{
"type": "object",
"fields": {
"total": "integer",
"arbitrages": "array of arbitrage opportunity objects with id, sport, tournament, market, bookmakers, and arb_percentage"
},
"sample": {
"data": {
"total": 14,
"arbitrages": [
{
"id": "6a3c2e784f873529e80f30bd",
"sport": "Football",
"arb_id": "e74fe0795405dd9a30194a9bb10936ce",
"status": 1,
"start_at": "xxxx",
"game_type": "prematch",
"bookmakers": [
{
"odd": "xx",
"away": "xxxxxx",
"home": "xxxxxx",
"icon": "https://oddsplug.com/bucket/bookmakers/msport.png",
"odds": {
"ov": "xx",
"un": "xx"
},
"teams": "xxxxxx vs xxxxxx",
"market": "ov",
"bookmaker": "MSport"
},
{
"odd": "xx",
"away": "xxxxxx",
"home": "xxxxxx",
"icon": "https://oddsplug.com/bucket/bookmakers/betwgb1.png",
"odds": {
"ov": "xx",
"un": "xx"
},
"teams": "xxxxxx vs xxxxxx",
"market": "un",
"bookmaker": "BetWGB"
}
],
"created_at": "2026-06-24T19:22:32.873Z",
"tournament": "xxxxx > xxxxx",
"updated_at": "2026-06-24T21:00:08.509Z",
"market_code": "ou_25",
"market_name": "Full time over/under 2.5",
"arb_percentage": "0.09",
"start_at_timestamp": 1782378000
}
]
},
"status": "success"
}
}About the Oddsplug API
What the API Returns
The fetch_arbitrages endpoint returns a list of current arbitrage opportunities sourced from Oddsplug. Each item in the arbitrages array includes an id, the sport, the tournament, the specific market (e.g. match winner, over/under), the bookmakers involved in the arbitrage, and the arb_percentage — the margin that makes the opportunity profitable regardless of outcome.
Filtering Results
Two optional input parameters let you narrow results: sport filters to a specific sport (such as football, tennis, or basketball), and game_type filters by whether the event is prematch or live. Both can be omitted to retrieve all current opportunities across all sports and game types. The response also includes a total integer reflecting the count of returned opportunities.
Data Availability Notes
Some fields — specifically team names and individual odds — may be obscured depending on your access level. The arb_percentage, market, tournament, and bookmakers fields are the core data exposed. Freshness of the opportunities reflects Oddsplug's real-time odds feed, so the results are time-sensitive by nature and intended to be polled regularly rather than cached.
The Oddsplug API is a managed, monitored endpoint for Oddsplug.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when Oddsplug.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 Oddsplug.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?+
- Alert system that notifies traders when arb_percentage crosses a defined threshold for a target sport
- Dashboard aggregating live arbitrage opportunities filtered by game_type for in-play betting workflows
- Automated logging of arbitrage opportunities by tournament and bookmaker pair for historical pattern analysis
- Filtering prematch arbs across multiple sports to prioritize markets with the highest margins
- Comparing bookmaker combinations appearing in arbitrages to identify which platforms offer the most frequent mismatches
- Building a sport-specific arb scanner that polls fetch_arbitrages on a schedule for football or tennis
| 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.