Genesis Arbitrage

Genesis Arbitrage · · 16 min de leitura

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=sport nos planos Pro e Max, a Genesis API retorna surebets pré-jogo de 13 plataformas, com um stake_unit para cada perna. O profit_usd delas é 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ívelO que contémExemplo
EventoEsporte, competição, times, inícioFutebol, Bundesliga, Bayern — Dortmund
MercadoTipo de aposta, período, linhaTotal 2.5, tempo regulamentar
ResultadoEm que é a apostaMais de 2.5
PreçoOdds de cada casa de apostasFonbet @1.95, Winline @2.02
HorárioQuando o preço foi atualizadohá 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çoOdd decimalProbabilidade
@2.25 em uma casa de apostas2.2544,44%
@3.60 em uma casa de apostas3.6027,78%
YES a 30¢ na Polymarket1 / 0.30 = 3.3330%

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.

ResultadoMelhor oddOnde1/k
1, vitória do Bayern@2.25Betcity0,44444
X, empate@3.60Marathon0,27778
2, vitória do Dortmund@3.80Winline0,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.

ApostaValorSe ganhar
Betcity · 1 @2.25US$ 451,04US$ 1.014,84
Marathon · X @3.60US$ 281,90US$ 1.014,84
Winline · 2 @3.80US$ 267,06US$ 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 verificarOnde dá erradoCampo em mode=sport
Partida e elencoBayern contra Bayern II, um time feminino ou de baseteams, flags
InícioUma casa de apostas remarcou a partidastarts_at
Tipo de mercadoResultado, handicap, total, BTTS, placar exatomarket_type
PeríodoTempo regulamentar ou a partida com prorrogaçãoperiod
LinhaOs handicaps −1.5 e −1.25 são apostas diferentesline
Resultados das pernasJuntas, as pernas devem cobrir todos os resultadoslegs[].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ívelCamposNo exemplo
Eventotitle, sport, league, teams, starts_atArsenal — Chelsea, soccer, Premier League
Mercadomarket_type, period, line, scoreTOT, FT, 2.5
Pernaplatform, side, outcome, coversfonbet, bet, Under 2.5, U
Preçoodds, price_avg, stake_unit, currency2.12, 0.471698, RUB
Resultadosize_usd, profit_pct, profit_usd1000, 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:

PernaValorSe ganhar
Polymarket · YES "Over 2.5" a 50,5¢US$ 258,52511,92 ações — US$ 511,92
Fonbet · Under 2.5 @2.12US$ 241,48US$ 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 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.