API de odds esportivas para arbitragem: eventos, odds e surebets via API
Em resumo
- Uma API de odds esportivas retorna eventos, mercados e as odds de cada casa de apostas, com o horário da última atualização. A probabilidade implícita de uma odd decimal é 1/k, e o preço de um contrato YES em um mercado de previsão é essa mesma probabilidade em dólares.
- Existe surebet quando a soma de 1/k das melhores odds de todos os resultados de um mercado é menor que 1, e cada aposta é proporcional a 1/k. A maioria dos erros acontece no pareamento: a partida, o mercado, o período e a linha devem ser os mesmos em todas as plataformas.
- Em
mode=sportnos planos Pro e Max, a Genesis API retorna surebets pré-jogo de 13 plataformas, com umstake_unitpara cada perna. Oprofit_usddelas é null porque o limite de aposta da casa de apostas é desconhecido.
Uma API de odds esportivas, também chamada de API de apostas esportivas, dá a um programa acesso à linha: eventos, mercados e as odds de cada casa de apostas, com o horário em que cada preço foi atualizado. Com esses dados, o programa compara preços entre plataformas e encontra surebets: apostas em todos os resultados de uma partida que terminam em lucro seja qual for o desfecho, desde que todas as apostas sejam aceitas e liquidadas com as mesmas regras. Isso é arbitragem esportiva, e a Genesis API entrega surebets prontas de 13 plataformas pelo endpoint /predictions/arbitrage com mode=sport.
O que uma API de odds esportivas retorna
Cada provedor dá nomes diferentes aos campos, mas uma API de odds descreve a linha em cinco níveis. Sem o período e a linha, duas odds não podem ser comparadas, e sem o horário não dá para saber se um preço ainda vale. A coluna da direita é um exemplo ilustrativo.
| Nível | O que contém | Exemplo |
|---|---|---|
| Evento | Esporte, competição, times, início | Futebol, Bundesliga, Bayern — Dortmund |
| Mercado | Tipo de aposta, período, linha | Total 2.5, tempo regulamentar |
| Resultado | Em que é a aposta | Mais de 2.5 |
| Preço | Odds de cada casa de apostas | Fonbet @1.95, Winline @2.02 |
| Horário | Quando o preço foi atualizado | há 12 segundos |
As odds chegam em formato decimal, fracionário ou americano, e as plataformas de previsão cotam o preço de um contrato em dólares em vez de odds. Os dados vêm da API aberta de uma plataforma ou de um provedor que reúne as linhas de muitas casas de apostas em um único formato. Os dados da Polymarket e da Kalshi estão no artigo sobre as APIs da Polymarket e da Kalshi.
Odds, probabilidade e preços em centavos
As odds decimais mostram quanto volta para cada dólar apostado, incluindo a aposta: US$ 100 a @2.25 viram US$ 225. O inverso é a probabilidade implícita: 1 / 2.25 = 0,4444, ou 44,44%. Odds fracionárias e americanas são convertidas em decimais com as fórmulas de Odds de apostas explicadas.
| Preço | Odd decimal | Probabilidade |
|---|---|---|
| @2.25 em uma casa de apostas | 2.25 | 44,44% |
| @3.60 em uma casa de apostas | 3.60 | 27,78% |
| YES a 30¢ na Polymarket | 1 / 0.30 = 3.33 | 30% |
Um contrato YES paga US$ 1 se o resultado acontecer, então seu preço em dólares é a estimativa de probabilidade do mercado. Um contrato NO em "vitória do Bayern" ganha se o Dortmund vencer ou se houver empate, como na dupla chance.
Em uma única casa de apostas, as probabilidades de todos os resultados de um mercado somam mais de 1, e o excesso é a sua margem. Exemplo ilustrativo: a linha da Fonbet em Bayern — Dortmund, 2.15 / 3.45 / 3.40, dá 0,46512 + 0,28986 + 0,29412 = 1,04910, uma margem de 4,91%. O cálculo passo a passo está em Como calcular a margem da casa de apostas.
Como encontrar uma surebet a partir das odds
Uma surebet é encontrada pelos melhores preços entre casas de apostas: para cada resultado do mercado, pega-se a maior odd e somam-se os 1/k. Exemplo ilustrativo: a mesma partida, o mercado de resultado final no tempo regulamentar.
| Resultado | Melhor odd | Onde | 1/k |
|---|---|---|---|
| 1, vitória do Bayern | @2.25 | Betcity | 0,44444 |
| X, empate | @3.60 | Marathon | 0,27778 |
| 2, vitória do Dortmund | @3.80 | Winline | 0,26316 |
L = 0.44444 + 0.27778 + 0.26316 = 0.98538
A soma é menor que 1, então há surebet, com lucro de 1 / 0.98538 − 1 = 1.48%. As linhas próprias das quatro casas de apostas no código abaixo têm margens de 3,8% a 5,1%; a surebet surge da diferença com que elas precificaram a partida.
A aposta total é dividida proporcionalmente a 1/k: de US$ 1.000, a vitória do mandante recebe 1.000 × 0,44444 / 0,98538 = US$ 451,04, e as outras apostas estão na tabela.
| Aposta | Valor | Se ganhar |
|---|---|---|
| Betcity · 1 @2.25 | US$ 451,04 | US$ 1.014,84 |
| Marathon · X @3.60 | US$ 281,90 | US$ 1.014,84 |
| Winline · 2 @3.80 | US$ 267,06 | US$ 1.014,83 |
Cada resultado devolve cerca de 1.000 / 0,98538 = US$ 1.014,84; o lucro no pior caso é de US$ 14,83 por causa do arredondamento das apostas.
A mesma lógica em código, tendo como entrada a linha de um mercado em quatro casas de apostas:
# Illustrative example: one 1X2 market line at four sportsbooks
line = {
"Fonbet": {"1": 2.15, "X": 3.45, "2": 3.40},
"Betcity": {"1": 2.25, "X": 3.20, "2": 3.40},
"Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
"Winline": {"1": 2.10, "X": 3.35, "2": 3.80},
}
def surebet(line, bank):
outcomes = next(iter(line.values())).keys()
# best odds for each outcome and the sportsbook offering them
best = {o: max((odds[o], bk) for bk, odds in line.items())
for o in outcomes}
total = sum(1 / k for k, _ in best.values())
if total >= 1:
return None # no surebet
for o, (k, bk) in best.items():
print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
return round((1 / total - 1) * 100, 2)
print(surebet(line, 1000), "%") # 1.48 %
Um mercado de dois resultados — handicap, totais, ambas marcam — tem duas chaves no dicionário, e a fórmula continua a mesma. O arredondamento das apostas e o recálculo após o movimento das odds estão na lição Como calcular uma surebet.
Pareamento: uma partida, um mercado, um período e uma linha
A fórmula só vale se todos os preços pertencerem ao mesmo mercado da mesma partida. As casas de apostas escrevem os nomes dos times de formas diferentes, os horários de início variam em minutos e os mercados têm nomes próprios. Um erro de pareamento gera uma surebet falsa: os 1/k somam menos de 1, mas em um dos resultados todas as apostas perdem.
| O que verificar | Onde dá errado | Campo em mode=sport |
|---|---|---|
| Partida e elenco | Bayern contra Bayern II, um time feminino ou de base | teams, flags |
| Início | Uma casa de apostas remarcou a partida | starts_at |
| Tipo de mercado | Resultado, handicap, total, BTTS, placar exato | market_type |
| Período | Tempo regulamentar ou a partida com prorrogação | period |
| Linha | Os handicaps −1.5 e −1.25 são apostas diferentes | line |
| Resultados das pernas | Juntas, as pernas devem cobrir todos os resultados | legs[].covers |
O tempo regulamentar no futebol são 90 minutos mais os acréscimos. As plataformas de apostas costumam liquidar nele o resultado da partida, os handicaps e os totais no futebol e no hóquei, a menos que o nome do mercado diga que prorrogação e pênaltis estão incluídos. Um mercado de vencedor em uma plataforma de previsão pode incluir a prorrogação, e então um empate no tempo regulamentar pode fazer o par inteiro perder.
Um handicap forma surebet com o handicap oposto do mesmo tamanho: mandante −1.5 e visitante +1.5. Em um handicap asiático de quarto, como −0.75, a aposta é dividida ao meio entre as duas linhas vizinhas, e mandante −0.75 com visitante +0.75 também cobre qualquer placar. Os totais se pareiam em uma mesma linha: mais de 2.5 com menos de 2.5.
O par inverso, mais de 2.5 e menos de 3.5, é um middle: com três gols, as duas apostas ganham. Na Genesis API, line e period são definidos uma única vez para toda a surebet, então pernas com linhas diferentes nunca caem na mesma linha da resposta.
Surebets pela Genesis API: mode=sport
O endpoint /predictions/arbitrage com mode=sport retorna surebets em que esse trabalho já está feito: os eventos são pareados entre plataformas, os melhores preços são escolhidos e as pernas das plataformas de previsão são percorridas no livro de ofertas com taxas. São 13 plataformas: Polymarket, Kalshi, Predict.fun e 10 plataformas de apostas — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB e Dafa Sports. Apenas pré-jogo: quando a partida começa, a surebet sai da resposta.
O modo faz parte dos planos Pro (US$ 100 por mês, um novo snapshot a cada 10 s) e Max (US$ 200, a cada 5 s); no Trial e no Start a requisição retorna 403 plan_restricted. A API não retorna a linha completa de cada casa de apostas: a resposta contém apenas as surebets encontradas, com a plataforma, o resultado e o preço de cada perna.
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=sport -d sport=soccer -d min_profit_pct=1.5
Exemplo ilustrativo: uma linha mode=sport da documentação com preços recalculados:
{
"id": "s:8812:FT:TOT:2.5:",
"kind": "sport",
"match": "sport",
"title": "Arsenal — Chelsea",
"category": "sports",
"sport": "soccer",
"league": "Premier League",
"teams": ["Arsenal", "Chelsea"],
"market_type": "TOT",
"period": "RT",
"line": 2.5,
"score": null,
"starts_at": 1794700800,
"size_usd": 1000,
"profit_usd": null,
"profit_pct": 2.39,
"legs": [
{
"platform": "polymarket",
"side": "yes",
"outcome": "Over 2.5",
"covers": ["O"],
"price_avg": 0.505,
"odds": null,
"stake_unit": 0.505,
"currency": "USD"
},
{
"platform": "fonbet",
"side": "bet",
"outcome": "Under 2.5",
"covers": ["U"],
"odds": 2.12,
"stake_unit": 0.471698,
"currency": "RUB"
}
]
}
Os cinco níveis da linha correspondem aos campos da resposta:
| Nível | Campos | No exemplo |
|---|---|---|
| Evento | title, sport, league, teams, starts_at | Arsenal — Chelsea, soccer, Premier League |
| Mercado | market_type, period, line, score | TOT, FT, 2.5 |
| Perna | platform, side, outcome, covers | fonbet, bet, Under 2.5, U |
| Preço | odds, price_avg, stake_unit, currency | 2.12, 0.471698, RUB |
| Resultado | size_usd, profit_pct, profit_usd | 1000, 2.39, null |
market_type é o mercado: WIN — resultado da partida, HCP — handicap, TOT — total, BTTS — ambas marcam, CS — placar exato, com o placar em score. side é yes ou no para a compra de um contrato e bet para uma aposta a odds. covers lista os resultados que uma perna cobre: aqui O é mais e U é menos.
Como dividir a aposta por stake_unit
stake_unit é quanto colocar em uma perna para ela devolver US$ 1 se ganhar. Para uma aposta a odds, é 1 / odds: 1 / 2.12 = 0,471698. Para a compra de YES ou NO, é o preço médio no livro de ofertas incluindo a taxa; o exemplo ilustrativo não tem taxa, então stake_unit é igual a price_avg.
As unidades somam 0,505 + 0,471698 = 0,976698, então o lucro é 1 / 0.976698 − 1 = 2.39%. Divida o seu próprio valor S com a fórmula da surebet: aposta da perna = S × stake_unit / Σ stake_unit. Para US$ 500:
| Perna | Valor | Se ganhar |
|---|---|---|
| Polymarket · YES "Over 2.5" a 50,5¢ | US$ 258,52 | 511,92 ações — US$ 511,92 |
| Fonbet · Under 2.5 @2.12 | US$ 241,48 | US$ 511,94 |
Qualquer resultado devolve cerca de US$ 511,93, um lucro no pior caso de US$ 11,92. size_usd é quanto os livros de ofertas das plataformas de previsão absorvem a esses preços. Aqui são US$ 1.000: 1.000 / 0,505 ≈ 1.980,2 ações, então a aposta na Fonbet poderia chegar a 1.980,2 × 0,471698 ≈ US$ 934,06 se a casa de apostas aceitar.
profit_usd é null porque o lucro em dólares depende de quanto a Fonbet aceita, e a casa de apostas não publica seu limite de aposta. Por isso o filtro min_profit_usd descarta toda surebet com uma perna em casa de apostas: filtre-as por min_profit_pct.
A aposta na Fonbet é em rublos (currency = RUB). A uma taxa ilustrativa de 80 ₽ por US$ 1, são 241,48 × 80 = 19.318,40 ₽, e menos de 2.5 devolve 19.318,40 × 2.12 = 40.955,01 ₽. O spread cambial na conversão não está incluído em profit_pct.
Python: surebets de futebol com min_profit_pct
O script pede surebets de futebol com lucro de 1,5% ou mais, imprime cada uma com o tempo até o início e divide o valor BANK entre as pernas por stake_unit. A chave vem da variável de ambiente GENESIS_API_KEY; como obtê-la está no início rápido.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500 # total stake for the whole surebet, $
def fetch():
while True:
r = requests.get(f"{API}/predictions/arbitrage",
headers=HEADERS, params=PARAMS, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
if r.status_code == 403:
raise SystemExit("mode=sport needs the Pro or Max plan")
r.raise_for_status()
return r.json()["data"]
def unit(leg): # $1 of winnings: stake_unit, else 1/odds or price
if leg.get("stake_unit"):
return leg["stake_unit"]
return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]
for row in fetch():
mkt = [row["market_type"], row["line"], row["period"]]
mkt = " ".join(str(v) for v in mkt if v is not None)
hours = (row["starts_at"] - time.time()) / 3600
print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
f"starts in {hours:.1f} h")
total = sum(unit(leg) for leg in row["legs"])
for leg in row["legs"]:
price = leg.get("odds") or leg.get("price_avg")
print(f" {leg['platform']}: {leg['outcome']} at {price} — "
f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")
O valor de cada perna é impresso em dólares ao lado da moeda da plataforma: converta uma aposta em rublos pela sua própria cotação. Se uma perna não tem stake_unit, unit recorre a 1 / odds ou price_avg sem a taxa, então o lucro sai um pouco maior do que realmente é.
Para acompanhar novas surebets, repita a requisição a cada meta.freshness_sec e compare os valores de id: cada surebet mantém o seu id. Uma resposta filtrada vem sem ETag, então você economiza cota pelo intervalo: uma requisição a cada 10 s no Pro dá 86.400 / 10 = 8.640 chamadas por dia e 8.640 × 30 = 259.200 em 30 dias contra uma cota de 5M, veja os limites da Genesis API. Os filtros league, platform (por exemplo fonbet) e max_days estão descritos no guia de endpoints dos mercados de previsão.
Riscos que a API não consegue verificar
A API precifica uma surebet a partir de um snapshot, enquanto você faz as apostas em duas ou três plataformas por conta própria, e cada uma delas pode quebrar a conta.
- As odds se movem. Passam segundos ou minutos entre o snapshot e a sua aposta: a casa de apostas reduz a odd, ou as ordens baratas do livro são executadas.
- Limites e limitação de apostas. A casa de apostas pode aceitar menos do que você pediu ou limitar a conta; os motivos estão em Por que as casas de apostas limitam arbitradores. Faça primeiro a aposta a odds e compre YES ou NO pelo valor aceito.
- Anulação. Se uma partida é cancelada ou adiada, a casa de apostas costuma devolver a aposta a odds 1, enquanto o mercado YES/NO é liquidado pelas suas próprias regras, e a surebet pode acabar em prejuízo.
- Moeda. A conversão entre rublos e dólares não está incluída no lucro da linha.
- Erro evidente. Uma odd muito acima das outras casas de apostas pode ser um erro, e a casa de apostas pode liquidar a aposta de novo.
As apostas são regulamentadas de forma diferente em cada país: verifique as leis locais e as regras de cada plataforma. A ordem de trabalho e todos os riscos estão reunidos na lição Riscos das surebets e regras de trabalho, e como a busca funciona é explicado em Scanner de surebets.
As colunas, os filtros e as etiquetas estão descritos no guia do modo Sport.
Perguntas e respostas
Existe uma API de odds esportivas gratuita?
Depende do provedor: as cotas de requisições e a lista de casas de apostas e mercados variam, e o acesso gratuito, quando existe, tem volume limitado. A Polymarket e a Kalshi entregam dados de mercado pelas APIs oficiais sem chave (Polymarket, Kalshi), mas são preços de contratos YES e NO, sem odds de casas de apostas. A Genesis API não tem plano gratuito: mode=sport está no Pro (US$ 100 por mês) e no Max (US$ 200); compare os planos em Preços da Genesis API.
A API tem odds ao vivo?
Não na Genesis API: o modo sport procura apenas surebets pré-jogo, e a surebet sai da resposta assim que a partida começa. Por que as arbitragens ao vivo quebram com mais frequência está em Arbitragem pré-jogo e ao vivo.
Por que profit_usd é null em uma surebet?
Pelo menos uma perna é uma aposta em casa de apostas, e a casa de apostas não publica o limite de aposta da sua conta. O percentual profit_pct é conhecido; calcule o valor de cada perna a partir de stake_unit.
Posso fazer apostas pela Genesis API?
Não. A Genesis API apenas lê dados: as apostas e compras você faz por conta própria nas plataformas, usando os links de legs[].url.