Documentação da API

Lista de jogos.

Parâmetros: status (scheduled|live|finished), competition (id), from/to (ISO 8601), limit (padrão 50, máx 200)

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/matches?status=scheduled&limit=5"

{ "data": [ { "id": "...", "competitionId": "...", "homeTeamId": "...", "homeTeamName": "Fluminense", "awayTeamId": "...", "awayTeamName": "Bragantino", "kickoffAt": "2026-07-17T23:00:00.000Z", "status": "scheduled", "slug": "fluminense-...", "matchday": 17 } ] }

Um jogo específico.

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/matches/id1000032566886838"

{ "data": { "id": "...", "homeTeamName": "Fluminense", "awayTeamName": "Bragantino", "status": "scheduled", ... } }

Melhor odd por mercado/seleção — a mesma comparação exibida no site. No plano Gratuito, é a melhor odd só entre as casas da sua seleção (veja "Planos" acima), não entre todas.

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/matches/id1000032566886838/best-odds"

{ "data": { "matchId": "...", "markets": { "1x2": { "home": { "odd_value": 2.0, "bookmaker_id": "kto" }, ... } }, "updatedAt": "..." } }

Odd de CADA casa por mercado/seleção — não só a vencedora. No plano Gratuito, só as casas da sua seleção aparecem.

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/matches/id1000032566886838/odds"

{ "data": { "matchId": "...", "markets": { "1x2": { "home": { "kto": 2.0, "betnacional": 1.9, "stake": 1.92 } } }, "updatedAt": "..." } }

Igual à rota acima, mas busca na fonte em vez de ler o último dado já calculado pela ingestão agendada — sujeito a um limite próprio e bem mais apertado de 100 chamadas por hora, compartilhado entre todos os consumidores da API. Todo pedido desconta dessa cota, mesmo quando a resposta vem de um cache interno de 60s por jogo — "cached": true no retorno indica isso. O cache não poupa a sua cota; ele poupa nosso servidor e o número de chamadas reais feitas à Odds-API.io quando o mesmo jogo é pedido várias vezes seguidas. Use a rota sem "/live" pro uso normal; use esta só quando o timing importar de verdade.

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/matches/id1000032566886838/odds/live"

{ "data": { "matchId": "...", "eventStatus": "pending", "markets": { "1x2": { "home": { "kto": 2.0 } } }, "fetchedAt": "...", "cached": false } }

Oportunidades de arbitragem detectadas. No plano Completo, lista completa com as casas/odds de cada perna. No Gratuito, uma prévia: contagem e margem das oportunidades ativas + um histórico recente resumido, sem as casas/odds que compõem cada uma (isso fica no Completo). No Gratuito os parâmetros status/limit são ignorados — a resposta é sempre esse retrato atual, só market/minMargin filtram o que entra na prévia.

Parâmetros: status (active, padrão | expired), minMargin (número, só afeta active), market, limit (padrão 50, máx 200) — status/limit ignorados no Gratuito

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/surebets?minMargin=2"

Completo: { "data": [ { "id": "...", "matchId": "...", "market": "1x2", "profitMarginPct": 3.42, "combo": { "home": { "odd_value": 2.1, "bookmaker_id": "kto" }, ... }, "detectedAt": "...", "expiredAt": null, "explanation": "..." } ] }
Gratuito: { "data": { "activeCount": 7, "maxMarginPct": 4.8, "avgMarginPct": 2.1, "recentlyDetected": [ { "matchId": "...", "market": "1x2", "profitMarginPct": 3.42, "detectedAt": "...", "expiredAt": null } ] }, "meta": { "tier": "gratuito", "note": "..." } }

Ranking de casas por margem média e precisão. Um período só (o mais recente calculado) — sem histórico por mês nesta versão. Disponível só no plano Completo — no Gratuito devolve 403 plan_required.

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/ranking"

{ "data": { "period": "2026-07", "summaryText": "...", "bookmakers": [ { "bookmakerId": "kto", "bookmakerName": "KTO", "avgMarginPct": 4.8, "sampleSize": 42, "accuracyScore": 0.61, "lowSample": false } ] } }

Casas de apostas comparadas.

Parâmetros: active (true, opcional)

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/bookmakers?active=true"

{ "data": [ { "id": "kto", "name": "KTO", "slug": "kto", "isActive": true, "licenseStatus": "licensed", "affiliateLink": null } ] }

Campeonatos cobertos.

Parâmetros: active (true, opcional)

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/competitions"

{ "data": [ { "id": "brasileirao-serie-a", "slug": "brasileirao", "name": "Brasileirão Série A", "shortLabel": "Brasileirão", "isActive": true, "isTemporary": false } ] }

Times cadastrados.

Parâmetros: competition (id, opcional)

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/teams?competition=brasileirao-serie-a"

{ "data": [ { "id": "...", "name": "Fluminense", "shortName": "FLU", "competitionId": "brasileirao-serie-a", "logoUrl": null } ] }

Lista estática de mercados e seleções, com rótulos em português.

curl -H "Authorization: Bearer $API_KEY" "https://ganhemaisbet.com/api/v1/markets"

{ "markets": [ { "key": "1x2", "label": "Resultado Final" }, ... ], "selections": [ { "key": "home", "label": "Casa" }, ... ] }