Documentación de Genesis API

Todo lo necesario para integrar: autenticación, límites, endpoints y esquemas de respuesta.

DocumentaciónArbitraje de predicciones

Arbitraje de predicciones

TrialStartProMax

Arbitraje entre plataformas de predicción, como en la página «Arbitraje de predicciones»: cada paquete se recorre por los libros de órdenes con comisiones y muestra el tamaño de la operación, la ganancia en $ y %, el APR y los riesgos. Modos: exact — eventos coincidentes exactamente y dutch — un conjunto de resultados en una plataforma (Start, Pro, Max); llm — pares verificados por IA y sport — surebets de casas de apuestas (Pro y Max). Cuando una pierna es una casa de apuestas, profit_usd es null: se desconocen los límites de apuesta de la casa.

GEThttps://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact
Probar
GET/v1/predictions/arbitrage?mode=exact

La clave se guarda solo en tu navegador y no se envía a ningún sitio salvo la API.

Pega tu clave y envía una petición — mostraremos una respuesta resumida.

Parámetros de la petición

Todos los parámetros son opcionales: sin filtros el endpoint devuelve el conjunto completo de datos.

ParámetroTipoDescripción
modestringexact (por defecto) y dutch — Start, Pro, Max; llm y sport — Pro y Max
categorystringFiltro por categoría
platformstringAl menos una pierna en esta plataforma o casa de apuestas; varias — separadas por coma
min_profit_pctnumberGanancia mínima, %
min_profit_usdnumberGanancia mínima, USD (las filas con profit_usd = null se omiten)
min_aprnumberAPR mínimo, %
max_daysnumberComo máximo estos días hasta la resolución
sport / leaguestringDeporte y liga para mode=sport, coincidencia exacta. Códigos de deporte: 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

Ejemplo de petición

bash
curl "https://api.genesisarbitrage.com/v1/predictions/arbitrage?mode=exact" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Ejemplo de respuesta

Ejemplo de respuesta — una entrada de datos, valores largos abreviados:

json
{
  "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"
    }
  ]
}

Ejemplo de fila con mode=sport

json
{
  "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 de la respuesta

CampoTipoDescripción
idstringId estable del paquete
kindstringcross — par de plataformas, dutch — conjunto de resultados, sport — surebet de casa de apuestas
matchstringexact, llm o sport
title / categorystringTítulo y categoría del evento o mercado
event_id / group_idstring | nullIds del evento y del grupo de pares
ends_at / days_left / starts_atnumber | nullHora de resolución, días hasta la resolución e inicio del partido (segundos unix)
size_usd / fees_usdnumberTamaño de la operación y comisiones, USD
profit_usd / profit_pctnumber | nullGanancia en USD y % de la apuesta; profit_usd = null — una pierna de casa de apuestas
apr_pctnumber | nullAPR, % (null si es menos de un día)
edge_centsnumberVentaja de precio, centavos por acción
sharesnumberAcciones en el paquete
risksstring[]Códigos de riesgo: reglas distintas, fechas de resolución distintas, etc.
first_seen / updated_atnumberCuándo apareció y se actualizó el paquete
legs[].market / platformstringEl mercado de la pierna y la plataforma o casa de apuestas
legs[].side / outcomestringQué comprar — yes, no o bet (apuesta en casa de apuestas) — y el resultado
legs[].price_best / price_avg / price_worstnumberMejor precio, precio medio y peor precio al recorrer el libro
legs[].shares / cost_usd / fee_usd / urlmixedAcciones, costo, comisión y enlace de la pierna
sport / league / teams / flagsmixedPara sport: deporte, liga, equipos, flags
market_type / period / line / scoremixedPara sport: tipo de mercado (WIN, HCP, TOT, BTTS, CS), período, línea, marcador
legs[].covers / odds / stake_unit / currencymixedPara sport: resultados que cubre la pierna, cuotas, parte de la apuesta y la moneda de la casa de apuestas