Betminer V3 API

AI-powered football predictions, probabilities, odds, and betting systems for 500+ leagues worldwide.

Base URL https://betminer.p.rapidapi.com Version 3.0

📊

Match Predictions

1X2, correct score, BTTS, over/under, half-time/full-time, and double chance.

💰

Value Bets

Probability vs odds analysis to identify value opportunities.

🎯

Acca Builder

Custom accumulator builder with configurable markets and selections.

Response Format

All endpoints return a standard JSON wrapper with success, data, and meta fields.

Success Response

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "count": 10,
    "cached": true,
    "generated_at": "2026-02-01T15:00:00Z"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "MATCH_NOT_FOUND",
    "message": "No match found for the given parameters"
  }
}

Countries & Leagues

GET /countries List all countries

Returns all countries that have leagues with match data.

// Response
{
  "name": "England",
  "code": "GB"
}

GET /leagues List all leagues

Returns all active leagues across all countries.

GET /leagues/{country} Leagues by country

Parameter	Type	Description
`country`	string	Country name (e.g. England, Spain)

// Response item
{
  "id": 39,
  "name": "Premier League",
  "slug": "england/premier-league",
  "country": "England",
  "country_code": "GB",
  "type": "league",
  "current_season": true
}

Matches

GET /matches/{date} Matches for a date

Returns all matches for a date or date range. Use /matches/{dateFrom}/{dateTo} for ranges.

Parameter	Type	Description
`date`	string	Date in YYYY-MM-DD format

Query Parameters

Parameter	Type	Description
`league_id`	int	Filter by competition ID
`country`	string	Filter by country name
`status`	string	Filter by status: NS, LIVE, FT, HT, 1H, 2H

GET /matches/live Live matches

Returns all currently in-play matches with live scores and predictions. Cache TTL: 1 minute.

GET /match/{matchId} Match detail by ID

Returns comprehensive match data including extended predictions, expected goals, tips, lineups, standings, head-to-head history, and recent form. See Match Detail Object.

Parameter	Type	Description
`matchId`	int	Unique match identifier

GET /match/{homeSlug}/{awaySlug} Match detail by team slugs

Returns the most recent match between two teams. Same response as /match/{matchId}.

Parameter	Type	Description
`homeSlug`	string	Home team slug (e.g. manchester-united)
`awaySlug`	string	Away team slug (e.g. liverpool)

Betting Systems

GET /value-bets/{dateFrom}/{dateTo} Value bet picks

Matches where bookmaker odds offer value relative to predicted probability. Value = (probability / 100) × odds − 1. Picks spaced 2+ hours apart.

Market	Threshold	Odds Range
BTTS Yes	avgbtts > 55	2.00 – 2.40
BTTS No	avgbtts < 45	2.00 – 2.40
Home Win	homewin > 55	2.00 – 2.30
Away Win	awaywin > 55	2.00 – 2.70
Over 2.5	over2 > 65	2.00 – 2.50
Over 3.5	over3 > 55	2.00 – 2.50

GET /accumulators/{dateFrom}/{dateTo} Accumulator picks

High-confidence picks with lower odds (1.75–1.95). Meta includes combined_odds.

Market	Threshold	Odds Range
BTTS Yes	avgbtts ≥ 70	1.75 – 1.95
Home Win	homewin > 60	1.75 – 1.95
Away Win	awaywin ≥ 55	1.75 – 1.95
Over 2.5	over2 ≥ 65	1.75 – 1.95
Over 3.5	over3 ≥ 45	1.75 – 1.95

GET /acca-builder Custom accumulator builder

Build a custom accumulator by selecting markets, number of picks, and time window. Each match qualifies for one market only.

Parameter	Type	Default	Description
`hours`	int	24	Lookahead window (max 72)
`selections`	int	5	Number of picks (max 15)
`btts`	Y/N	Y	Include BTTS market
`over25`	Y/N	Y	Include Over 2.5 Goals
`over15`	Y/N	N	Include Over 1.5 Goals
`ftr`	Y/N	Y	Include Full Time Result
`fh_goals`	Y/N	N	Include First Half Goals

Match Object

Returned by /matches and /matches/live endpoints.

{
  "match_id": 1052483,
  "fixture_slug": "manchester-united-vs-liverpool",
  "kickoff": "2026-02-01T15:00:00Z",
  "status": "NS",
  "minute": null,

  "home_team": {
    "id": 33,
    "name": "Manchester United",
    "slug": "manchester-united",
    "logo": "https://..."
  },

  "away_team": { /* same structure */ },

  "competition": {
    "id": 39,
    "name": "Premier League",
    "slug": "england/premier-league",
    "country": "England",
    "country_code": "GB"
  },

  "score": {
    "home": null,  "away": null,
    "ht_home": null,  "ht_away": null
  },

  "probabilities": {
    "home_win": 45,   "draw": 23,   "away_win": 32,
    "btts": 68,
    "over_15": 85,   "over_25": 62,   "over_35": 38,
    "fh_over_05": 72,  "fh_over_15": 45
  },

  "predictions": {
    "result": "home_win",
    "correct_score": "2-1",
    "htft": "HH",
    "btts": true,
    "over_25": true
  },

  "odds": {
    "home_win": "2.40",  "draw": "3.20",  "away_win": "2.80",
    "btts_yes": "1.85",  "btts_no": "1.95",
    "over_15": "1.30",   "over_25": "1.90",  "over_35": "3.00",
    "fh_over_05": "1.44", "fh_over_15": "3.05",
    "dc_1x": "1.45",    "dc_12": "1.30",   "dc_x2": "1.50"
  },

  "form": {
    "home": "WWDLW",  "away": "WLDWW",
    "home_btts": "YYNYN",  "away_btts": "YYYNY"
  }
}

Notes: Probabilities are integers 0–100. Odds are strings to 2 decimal places (e.g. "3.00"). The fixture_slug is for building matchup URLs.

Match Detail Object

Returned by /match/{id} and /match/{home}/{away}. Includes all fields from the Match Object plus:

Extended Probabilities

Field	Type	Description
`over_05`	int	Over 0.5 goals probability
`ht_home`	int	Half-time home win probability
`ht_draw`	int	Half-time draw probability
`ht_away`	int	Half-time away win probability

Extended Predictions

Field	Type	Description
`btts_win`	string	BTTS + result combo (e.g. "1 & BTTS")
`btts_bh`	number	BTTS in both halves probability
`avghome`	number	Expected home goals (e.g. 1.45)
`avgaway`	number	Expected away goals (e.g. 0.92)
`avgtot`	number	Expected total goals (e.g. 2.37)
`avgfh`	number	Expected first-half goals (e.g. 1.10)

Additional Sections

Field	Type	Description
`tips`	array	Auto-generated betting tips (up to 3), each with `selection` and `odds`
`lineups`	array	Team lineups with formations (empty array if unavailable)
`standings`	array	League standings table (null if unavailable)
`head_to_head`	array	Last 10 meetings between the two teams
`home_recent`	array	Last 6 matches for home team
`away_recent`	array	Last 6 matches for away team

Prediction Result Values

The predictions.result field returns one of six outcomes. Every match gets a prediction — if no strong single outcome, Double Chance is assigned.

Value	Display	Criteria
`home_win`	1	Home win probability > 55%
`away_win`	2	Away win probability > 55%
`draw`	X	Draw probability > 40%
`home_or_draw`	1X	Combined ≥ 65%, home > away
`away_or_draw`	X2	Combined ≥ 65%, away > home
`home_or_away`	12	Combined ≥ 70%, draw < 25%