Sports Arbitrage Scanner

A ClawHub automaton skill that continuously monitors sports betting odds from multiple bookmakers, identifies arbitrage opportunities, and reports guaranteed-profit trade setups.

How Arbitrage Works

An arbitrage opportunity exists when the sum of implied probabilities across all outcomes of a match (using the best available odds from any bookmaker) is less than 1.0. This means you can stake proportionally on all outcomes and lock in a profit no matter who wins.

Implied probability of outcome = 1 / decimal_odds Arb exists when: sum(1/odds_i for all outcomes) < 1.0 Profit % = (1 - sum_of_implied_probs) / sum_of_implied_probs * 100 Stake for outcome i = (total_stake / odds_i) / sum_of_implied_probs

Environment Variables

ODDS_API_KEY (optional) API key for The Odds API (https://the-odds-api.com). Free tier allows ~500 requests/month. If not set, the skill falls back to built-in sample/demo data so it can still demonstrate functionality.

MIN_PROFIT_PCT (optional, default: 0.5) Minimum profit percentage to report. Arbs below this threshold are silently filtered out. Increase to reduce noise, decrease to surface more marginal arbs.

TOTAL_STAKE (optional, default: 1000) Hypothetical total stake amount (in your currency) used to compute the concrete stake split per outcome. Purely illustrative — adjust to your bankroll.

SPORTS (optional, default: soccer_epl,basketball_nba,americanfootball_nfl) Comma-separated list of sport keys to scan. Valid sport keys are documented at https://the-odds-api.com/sports-odds-data/sports-apis.html

RESULTS_FILE (optional, default: /tmp/sports_arb_results.json) Path where the JSON results file is written after each scan run.

Output

Each detected arbitrage opportunity is logged to stdout and appended to the JSON results file. The JSON schema per opportunity:

{ "match": "Team A vs Team B", "sport": "soccer_epl", "commence_time": "2026-03-21T15:00:00Z", "profit_pct": 1.23, "total_implied_prob": 0.9879, "outcomes": [ { "name": "Team A", "bookmaker": "pinnacle", "odds": 2.10, "implied_prob": 0.4762, "stake": 476.19, "potential_return": 1000.00 }, ... ], "total_stake": 1000, "guaranteed_return": 1012.30, "detected_at": "2026-03-21T03:00:00Z" }