Developer Tools

wagerbase API

Free, public JSON endpoints for real-time odds, AI predictions, steam moves, and football analytics. Built for developers, AI agents, and data consumers.

/api/docsRSS Feed

Quick Start

Getting Started

All endpoints return JSON. Without an API key you get basic data — with a free key you unlock full data including edges, probabilities, xG, and confidence scores. 100 requests/day on the free tier.

Get Your Free API Key

# Without key (basic data, premium fields hidden)

curl https://wagerbase.io/api/edge?min_edge=5

# With API key (full data including edges & probabilities)

curl -H "X-API-Key: wb_your_key" https://wagerbase.io/api/edge?min_edge=5

# Discover all endpoints

curl https://wagerbase.io/api/docs

12

Endpoints

100/day

Free Tier

JSON

Response Format

API Reference

Endpoints

Match Odds + Predictions

5-min in-memory + Supabase L2
GET /api/odds

Full match odds across 60+ bookmakers with xG model predictions for any league. Returns fixtures with odds across all markets, model probabilities, edges, xG data, top scorelines, BTTS, and Over/Under.

Parameters

leaguerequiredLeague slug (e.g. premier-league, championship, la-liga)
matchSingle event ID for match-level data

Weekly Predictions

5-min
GET /api/predictions

AI-powered weekly predictions with confidence scores and accuracy track record. Each prediction includes the model type, predicted outcome, bookmaker odds, edge percentage, and confidence rating.

Parameters

leaguerequiredLeague slug

Edge Picks

5-min
GET /api/edge

Today's highest-edge predictions from the wagerbase model. Returns actionable picks with probability, implied probability, edge, odds, confidence, and bookmaker deeplinks.

Parameters

leagueFilter by league slug
min_edgeMinimum edge in percentage points (default: 3)
limitMax results (default: 20, max: 50)

Multi-Bookmaker Odds Comparison

5-min
GET /api/odds-comparison

Compare odds across 60+ bookmakers with consensus pricing. Returns best odds, fair odds, overround, bookmaker-by-bookmaker odds, and movement indicators.

Parameters

sportrequiredSport key (e.g. soccer_epl, soccer_spain_la_liga)
marketh2h | totals | btts (default: h2h)

Steam Moves

Live
GET /api/steam-moves

Detected sharp money movements across 60+ bookmakers in real-time. Returns signal tier (strong/moderate/weak), signal score, bookmaker count, Pinnacle-led flag, direction, and historical hit rates.

Parameters

sportSport key (default: soccer_epl)
limitNumber of results (default: 20)
includeWeakInclude weak signals (default: false)

Player Props

5-min
GET /api/player-props

Player prop analysis with edge detection. Returns player-level data including shots average, goals average, xG average, anytime scorer edge, and cards average.

Parameters

leaguerequiredLeague slug (e.g. premier_league)
fixtureSingle fixture event ID
sortshots | goals | xg | edge

Accumulators

5-min
GET /api/accumulators

Daily accumulator predictions with live leg tracking. Returns accumulators with individual legs, combined odds, stake, live status, and ROI.

Parameters

dateYYYY-MM-DD (default: today)
range'week' for 7-day range
stats'true' for performance stats

Model Wars — AI vs AI

5-min
GET /api/model-wars

AI model predictions from Claude, Grok, and GPT-5. Returns today's picks, all-time leaderboard, weekly leaderboard, and recent settled results.

Parameters

dateYYYY-MM-DD (default: today)

Performance Track Record

5-min
GET /api/performance

Historical track record with hit rate, ROI, and cumulative P&L. Returns hero stats, cumulative P&L chart data, monthly breakdown, league breakdown, market breakdown, and recent picks.

Parameters

leagueall | league-slug
strategyStrategy filter

Blog API

Dynamic
GET /api/blog

Read blog posts including match previews, analysis, steam alerts, and guides. Retrieve post listings with pagination or full markdown content for a single post by slug.

Parameters

typematch-preview | match-preview-daily | weekly-preview | steam-alert | guide
sportfootball (default)
limit1-50 (default: 10)
offsetPagination offset (default: 0)
slugGet single post with full content

Activity Feed

30s
GET /api/accuracy/feed

Unified activity feed across all products in reverse-chronological order. Returns predictions, steam moves, props, and accumulators with status, odds, edge, and profit/loss.

Homepage Dashboard

30s
GET /api/homepage

Complete dashboard data in one call. Returns live scores, predictions, accumulators, steam moves, blog posts, performance stats, and match odds.

Data Feeds

RSS & Discovery

RSS Feed

application/rss+xml

RSS 2.0 feed of the latest 30 blog posts. Compatible with all major feed readers, AI aggregators, and content syndication tools.

https://wagerbase.io/feed.xml

API Discovery

application/json

Machine-readable JSON directory of all public API endpoints. AI agents and developers use this for self-discovery.

https://wagerbase.io/api/docs

Response Format

Example Response

All API responses follow a consistent structure. Here's an example from the Edge Picks endpoint:

{
  "ok": true,
  "generated": "2026-03-11T12:00:00.000Z",
  "count": 3,
  "picks": [
    {
      "match": "Arsenal vs Chelsea",
      "homeTeam": "Arsenal",
      "awayTeam": "Chelsea",
      "league": "premier-league",
      "kickoff": "2026-03-15T15:00:00Z",
      "prediction": "Home Win",
      "market": "match_winner",
      "probability": 0.68,
      "impliedProbability": 0.56,
      "edge": 12.1,
      "odds": 1.78,
      "confidence": "high",
      "modelType": "ensemble"
    }
  ]
}

Usage

Usage Notes

Rate Limits

No hard rate limits currently. Please be reasonable — if you need high-frequency access, get in touch.

Caching

Most endpoints cache for 5 minutes. Respect Cache-Control headers for optimal performance.

Attribution

If you display wagerbase data publicly, please link back to wagerbase.io.

Affiliate Links

Some responses include bookmaker affiliate deeplinks where applicable.

Contact

Questions or partnership enquiries? hello@wagerbase.io

Back to wagerbase