Documentação da Genesis API
Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.
Arbitragem de previsões
Arbitragem entre plataformas de previsão, como na página «Arbitragem de previsões»: cada pacote é percorrido pelos order books com taxas e mostra o tamanho da operação, o lucro em $ e %, o APR e os riscos. Modos: exact — eventos exatamente correspondentes e dutch — um conjunto de resultados em uma plataforma (Start, Pro, Max); llm — pares verificados por IA e sport — surebets de casas de apostas (Pro e Max). Quando uma perna é uma casa de apostas, profit_usd é null: os limites de aposta da casa são desconhecidos.
https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact/v1/predictions/arbitrage?mode=exactA chave fica só no seu navegador e não é enviada a lugar nenhum além da API.
Cole sua chave e envie uma requisição — mostraremos uma resposta resumida.
Parâmetros da requisição
Todos os parâmetros são opcionais: sem filtros o endpoint retorna o conjunto completo de dados.
| Parâmetro | Tipo | Descrição |
|---|---|---|
mode | string | exact (padrão) e dutch — Start, Pro, Max; llm e sport — Pro e Max |
category | string | Filtro por categoria |
platform | string | Pelo menos uma perna nesta plataforma ou casa de apostas; várias — separadas por vírgula |
min_profit_pct | number | Lucro mínimo, % |
min_profit_usd | number | Lucro mínimo, USD (linhas com profit_usd = null são ignoradas) |
min_apr | number | APR mínimo, % |
max_days | number | No máximo este número de dias até a resolução |
sport / league | string | Esporte e liga para mode=sport, correspondência exata. Códigos de esporte: soccer, basketball, hockey, american_football, baseball, tennis, mma, boxing, volleyball, handball, table_tennis, cricket, rugby, darts, snooker, futsal, esports_cs2, esports_dota2, esports_lol, esports_valorant, esports_other |
Exemplo de requisição
curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Exemplo de resposta
Exemplo de resposta — um elemento de dados, valores longos abreviados:
{
"id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…a93a",
"kind": "cross",
"match": "exact",
"title": "Will Jean Castex win the 2027 French presidential election?",
"category": "Elections",
"event_id": null,
"group_id": "g:cd2ffb419bd1",
"ends_at": 1843308000,
"days_left": 562.87,
"starts_at": null,
"size_usd": 107175.08,
"fees_usd": 28.08,
"profit_usd": 153.69,
"profit_pct": 0.14,
"apr_pct": 0.1,
"edge_cents": 0.18,
"shares": 107356.85,
"risks": ["rules_differ", "end_mismatch"],
"first_seen": 1794526832,
"updated_at": 1794675861,
"legs": [
{
"market": "polymarket:0x8c1f…a93a",
"platform": "polymarket",
"side": "yes",
"outcome": "Jean Castex",
"price_best": 0.001,
"price_avg": 0.0013,
"price_worst": 0.002,
"shares": 107356.85,
"cost_usd": 140.3,
"fee_usd": 5.6,
"url": "https://polymarket.com/event/next-french-presidential-election"
},
{
"market": "kalshi:KXFRENCHPRES-27-JCAS",
"platform": "kalshi",
"side": "no",
"outcome": "No",
"price_best": 0.997,
"price_avg": 0.997,
"price_worst": 0.997,
"shares": 107356.85,
"cost_usd": 107034.78,
"fee_usd": 22.48,
"url": "https://kalshi.com/events/KXFRENCHPRES-27"
}
]
}Exemplo de linha mode=sport
{
"id": "s:8812:RT: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", "url": "https://polymarket.com/…" },
{ "platform": "fonbet", "side": "bet", "outcome": "Under 2.5", "covers": ["U"],
"odds": 2.12, "stake_unit": 0.471698, "currency": "RUB", "url": "https://www.fon.bet/…" }
]
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Id estável do pacote |
kind | string | cross — par de plataformas, dutch — conjunto de resultados, sport — surebet de casa de apostas |
match | string | exact, llm ou sport |
title / category | string | Título e categoria do evento ou mercado |
event_id / group_id | string | null | Ids do evento e do grupo de pares |
ends_at / days_left / starts_at | number | null | Hora da resolução, dias até a resolução e início da partida (segundos unix) |
size_usd / fees_usd | number | Tamanho da operação e taxas, USD |
profit_usd / profit_pct | number | null | Lucro em USD e % da aposta; profit_usd = null — uma perna de casa de apostas |
apr_pct | number | null | APR, % (null quando faltam menos de um dia) |
edge_cents | number | Vantagem de preço, centavos por share |
shares | number | Shares no pacote |
risks | string[] | Códigos de risco: regras diferentes, datas de resolução diferentes, etc. |
first_seen / updated_at | number | Quando o pacote apareceu e foi atualizado |
legs[].market / platform | string | Mercado da perna e plataforma ou casa de apostas |
legs[].side / outcome | string | O que comprar — yes, no ou bet (aposta na casa) — e o resultado |
legs[].price_best / price_avg / price_worst | number | Melhor preço, preço médio e pior preço ao percorrer o book |
legs[].shares / cost_usd / fee_usd / url | mixed | Shares, custo, taxa e link da perna |
sport / league / teams / flags | mixed | Para sport: esporte, liga, times, flags |
market_type / period / line / score | mixed | Para sport: tipo de mercado (WIN, HCP, TOT, BTTS, CS), período, linha, placar |
legs[].covers / odds / stake_unit / currency | mixed | Para sport: resultados cobertos pela perna, odds, parcela da aposta e a moeda da casa de apostas |