Betting Research
Multi-source data aggregator for sports betting analysis. Pulls from free and paid APIs to give you an edge.
Data Sources
| Source | Data | Cost | Rate Limit |
|---|---|---|---|
| TheSportsDB | Fixtures, results, H2H, team info | Free | No limit |
| API-Football | Lineups, injuries, player stats, xG | 100 calls/day free | 100/day |
| Open-Meteo | Weather (precipitation, wind) | Free | No limit |
| The Odds API | Current odds, bookmaker prices | 500 calls/month free | 500/mo |
Quick Start
# Research a specific match
python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py "Liverpool vs Everton"
# Research a team
python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py --team "Bolton Wanderers"
What You Get
Basic Analysis (Free APIs)
- ✅ Team form (last 5 matches)
- ✅ Win/draw/loss record
- ✅ Goals scored/conceded
- ✅ Upcoming fixtures
- ✅ Head-to-head history
- ✅ Weather conditions
Pro Analysis (with API-Football key)
- ⭐ Confirmed lineups (1 hour before kickoff)
- ⭐ Injury/suspension reports
- ⭐ Expected goals (xG) data
- ⭐ Player form and ratings
- ⭐ Manager tactics info
Setup
The Odds API (already have)
Key stored at: ~/.config/the-odds-api/key
API-Football (optional, for pro features)
- Sign up: https://www.api-football.com/pricing
- Get free tier: 100 calls/day
- Save key:
mkdir -p ~/.config/api-football
echo '{"api_key": "YOUR_KEY"}' > ~/.config/api-football/config.json
Usage Examples
Pre-match research:
python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py "Bolton vs Plymouth"
Full analysis (uses more API calls):
python3 ~/.openclaw/workspace/skills/betting-research/scripts/betting_research.py "Liverpool vs Man City" --full
Check multiple games efficiently:
# Uses only 3-4 API calls per match
# 100 calls = ~25 matches per day
Interpreting Results
Value Indicators
- Form streaks — teams on hot/cold runs
- H2H dominance — historical advantage
- Weather impact — rain = lower scoring
- Odds mispricing — bookie odds vs. true probability
What NOT to Expect
- ❌ Guaranteed winners
- ❌ "Bet on this" tips
- ❌ Inside information
What TO Expect
- ✅ Data patterns
- ✅ Value opportunities
- ✅ Informed decisions
Pro Tips
- Check lineups 1 hour before kickoff — key players resting = different bet
- Weather matters — rain, wind affect totals (under value)
- H2H at this venue — home advantage varies by team
- Motivation check — cup games, relegation battles
API Call Budgeting
| Task | Calls |
|---|---|
| Basic match research | 3-4 |
| Full analysis + lineups | 8-10 |
| Team form check | 2-3 |
| Odds comparison | 1 |
100 calls/day = 10-15 full match analyses
See references/data-sources.md for API details.