Mercados de predicción y surebets en Genesis API: endpoints, filtros y campos
En resumen
- Seis endpoints: arbitraje de predicción y estado de las plataformas desde el plan Start; analítica, smart money, grandes operaciones y ranking de traders en Pro y Max.
- Los paquetes de arbitraje llegan calculados con los libros de órdenes y las comisiones: tamaño de la operación, beneficio en $ y %, APR, días hasta la liquidación y códigos de riesgo.
- El modo sport devuelve surebets en 13 plataformas, solo prepartido. Cuando una pata es una apuesta a cuota, profit_usd es null porque se desconoce el límite de apuesta.
Genesis API ofrece datos de mercados de predicción mediante seis endpoints GET: paquetes de arbitraje entre Polymarket, Kalshi, Limitless, Predict.fun y Opinion, surebets en 13 plataformas, estado de las plataformas, analítica, smart money, grandes operaciones y el ranking de traders. Son los datos de las páginas Arbitraje de predicción, Analítica y Smart Money, en formato JSON. Con ellos puedes montar un bot, un panel o alertas; las operaciones y apuestas las haces tú en las plataformas.
Endpoints y planes
| Endpoint | Qué devuelve | Planes de API |
|---|---|---|
/predictions/arbitrage | Paquetes de arbitraje y surebets | Start, Pro, Max; modos llm y sport — Pro, Max |
/predictions/platforms | Estado de las plataformas | Start, Pro, Max |
/predictions/analytics | KPI, movimientos de precio, flujos de dinero | Pro, Max |
/predictions/smart-money | Grandes operaciones, ballenas, patrones de insiders | Pro, Max |
/predictions/trades | Cinta de operaciones de Polymarket | Pro, Max |
/predictions/traders | Top 300 de traders de Polymarket por PnL | Pro, Max |
En Trial los seis devuelven 403 plan_restricted; en Start también lo hacen las peticiones con mode=llm y mode=sport. El formato de las respuestas se explica en la guía de respuestas y errores, la cuota en la guía de límites.
Arbitraje de predicción: modos
El parámetro mode elige qué paquetes devuelve /predictions/arbitrage.
mode | Qué obtienes | kind | Planes |
|---|---|---|---|
exact | El mismo evento en dos plataformas, el valor por defecto | cross | Start, Pro, Max |
dutch | Un conjunto de resultados de un evento en una plataforma | dutch | Start, Pro, Max |
llm | Pares de eventos verificados por IA | cross | Pro, Max |
sport | Surebets en partidos | sport | Pro, Max |
El beneficio ya está calculado con los libros de órdenes de las plataformas y las comisiones. Petición de paquetes exact con al menos un 1 % de beneficio que se liquiden en 30 días:
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=exact -d min_profit_pct=1 -d max_days=30
Filtros
| Parámetro | Tipo | Qué hace |
|---|---|---|
mode | string | exact (por defecto), dutch, llm o sport |
category | string | Categoría, como en el campo category |
platform | string | Al menos una pata en esta plataforma; varias, separadas por comas |
min_profit_pct | number | Beneficio mínimo, % |
min_profit_usd | number | Beneficio mínimo, $; se omiten las filas con profit_usd = null |
min_apr | number | APR mínimo, % |
max_days | number | Como máximo estos días hasta la liquidación |
sport, league | string | Deporte y liga, para mode=sport |
Los filtros son opcionales y se combinan. Escribe la plataforma como en legs[].platform: polymarket, kalshi, fonbet. Un mode desconocido devuelve 400 bad_request.
Un paquete y sus patas
Ejemplo ilustrativo: una fila mode=exact de la documentación, abreviada.
{
"id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…",
"kind": "cross",
"match": "exact",
"title": "Will Jean Castex win the 2027 French presidential…",
"category": "Elections",
"ends_at": 1843308000,
"days_left": 562.87,
"size_usd": 107175.08,
"fees_usd": 28.08,
"profit_usd": 153.69,
"profit_pct": 0.14,
"apr_pct": 0.1,
"shares": 107356.85,
"risks": ["rules_differ", "end_mismatch"],
"legs": [
{
"platform": "polymarket",
"side": "yes",
"outcome": "Jean Castex",
"price_avg": 0.0013,
"cost_usd": 140.3,
"fee_usd": 5.6,
"url": "https://polymarket.com/event/next-french-presidential-…"
},
{
"platform": "kalshi",
"side": "no",
"outcome": "No",
"price_avg": 0.997,
"cost_usd": 107034.78,
"fee_usd": 22.48,
"url": "https://kalshi.com/events/KXFRENCHPRES-27"
}
]
}
| Campo | Significado |
|---|---|
id, first_seen, updated_at | Id estable, cuándo apareció el paquete y cuándo se actualizó |
kind, match | cross, dutch o sport; match es exact, llm o sport |
title, category | Evento o mercado y su categoría |
ends_at, days_left, starts_at | Momento de liquidación, días hasta la liquidación, inicio del partido |
size_usd, fees_usd, shares | Tamaño de la operación y comisiones en $, número de shares |
profit_usd, profit_pct, apr_pct | Beneficio en $ y %, APR; apr_pct es null con menos de un día |
edge_cents, risks | Ventaja de precio en centavos por share, códigos de riesgo |
legs[].platform, market, outcome | Plataforma, mercado y resultado de la pata |
legs[].side | yes o no — qué comprar; bet — una apuesta a cuota |
legs[].price_best, price_avg, price_worst | Mejor precio, precio medio y peor precio al recorrer el libro |
legs[].shares, cost_usd, fee_usd, url | Shares, coste, comisión y enlace al mercado de la pata |
El precio de una pata es una fracción de dólar: una share devuelve 1 $ si su resultado gana, así que 0.997 son 99,7 ¢. Si ambas plataformas liquidan igual, una pata gana pase lo que pase, y shares es la cantidad que recibes. rules_differ indica que las reglas de liquidación de las plataformas pueden diferir; end_mismatch, que sus fechas de liquidación no coinciden.
En el ejemplo, 107.356,85 − 107.175,08 − 28,08 = 153,69 $ de beneficio, es decir, 153,69 / 107.203,16 = 0,14 %. El dinero queda bloqueado 562,87 días hasta la liquidación, así que la tasa anual resulta 0,14 × 365 / 562,87 ≈ 0,1 %. El filtro max_days descarta esos paquetes.
Modo sport: surebets
Una fila sport es un mercado de un partido: 2 o 3 patas en plataformas distintas que juntas cubren todos sus resultados. Son 13 plataformas: Polymarket, Kalshi, Predict.fun y 10 plataformas de apuestas — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB y Dafa Sports. Solo prepartido: en cuanto empieza el partido, la surebet sale de la lista.
Ejemplo ilustrativo: una fila mode=sport de la documentación con precios recalculados.
{
"id": "s:8812:RT:TOT:2.5:",
"kind": "sport",
"title": "Arsenal — Chelsea",
"sport": "soccer",
"league": "Premier League",
"teams": ["Arsenal", "Chelsea"],
"market_type": "TOT",
"period": "RT",
"line": 2.5,
"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"
}
]
}
| Campo | Significado |
|---|---|
sport, league, teams, flags | Deporte, liga, equipos, etiquetas del partido |
market_type | WIN — resultado, HCP — hándicap, TOT — total, BTTS — ambos equipos marcan, CS — resultado exacto |
period, line, score | Periodo de liquidación, línea de hándicap o total, marcador para CS |
legs[].covers | Resultados que cubre la pata: O — más de, U — menos de |
legs[].odds | Cuota decimal; null para una compra de YES o NO |
legs[].stake_unit | Parte de la apuesta: cuánto poner en la pata para obtener 1 $ si gana, comisiones incluidas |
legs[].currency | La moneda de la plataforma |
Para una apuesta a cuota, stake_unit = 1 / odds: 1 / 2,12 = 0,471698. Las unidades de apuesta de todas las patas suman 0,505 + 0,471698 = 0,976698, por debajo de 1, de ahí un beneficio de 1 / 0,976698 − 1 = 2,39 %. Para repartir tu propio importe, usa apuesta de la pata = importe × stake_unit / Σ stake_unit.
size_usd es el importe de compras en plataformas de predicción que sus libros de órdenes pueden absorber. Con 1.000 $ a 0,505 se compran 1.000 / 0,505 ≈ 1.980,2 shares YES de «Over 2.5». Para que «Under 2.5» devuelva lo mismo, la apuesta en Fonbet es 1.980,2 × 0,471698 ≈ 934,06 $.
Fonbet acepta apuestas en rublos (currency = RUB): convierte el importe a tu propio tipo de cambio, porque el cambio no forma parte de profit_pct. Aquí profit_usd es null porque la plataforma de apuestas no publica su límite de apuesta.
Estado de las plataformas
/predictions/platforms muestra cuán frescos son los datos de arbitraje. No tiene parámetros; data contiene dos listas:
{
"platforms": [
{
"platform": "kalshi",
"mode": "rest",
"quotes_at": 1794675858,
"full_scan_at": 1794675012,
"markets": 26187,
"hot_markets": 188
}
],
"bookmakers": [
{
"bookmaker": "fonbet",
"title": "Fonbet",
"ok": true,
"events": 1840,
"matched_events": 212,
"updated_at": 1794675855,
"currency": "RUB"
}
]
}
platforms[].mode— modo del feed de la plataforma de predicción:ws,restodowncuando el feed no funciona.quotes_atyfull_scan_at— hora de las últimas cotizaciones y del último escaneo completo de mercados;marketsyhot_markets— mercados en total y mercados activos.bookmakers[]— plataformas de apuestas:ok— si la recopilación funciona,eventsymatched_events— eventos en total y emparejados con otras plataformas,currency— la moneda de las apuestas.
Conviene omitir los paquetes con una plataforma en down o con ok = false: sus precios pueden haberse movido.
Analítica, smart money, operaciones y traders
Cuatro endpoints de Pro y Max replican las pantallas de las guías de Analítica y Smart Money.
| Endpoint | Parámetros | Qué contiene |
|---|---|---|
/predictions/analytics | ninguno | KPI, movimientos de precio en 1 h y 24 h, flujos de dinero, mercados que se liquidan pronto, mercados nuevos |
/predictions/smart-money | ninguno | KPI, flujos de dinero, insiders, concentration, smart_vs_price |
/predictions/trades | period, wallet, category, side, min_usd, insider | Operaciones de Polymarket, las más recientes primero |
/predictions/traders | period: 30d (por defecto), 7d, all | Top 300 de traders de Polymarket por PnL |
La etiqueta insider describe el patrón de comportamiento de una wallet y no prueba nada: una dirección nueva de un trader con experiencia puede operar igual.
Parámetros de la cinta de operaciones; period fija el umbral:
| Parámetro | Tipo | Qué hace |
|---|---|---|
period | string | live (por defecto) — operaciones desde 1.000 $, desde 100 $ para una wallet smart; today y 7d — takers desde 5.000 $ |
wallet | string | Operaciones de una wallet |
category | string | Categoría del mercado |
side | string | buy o sell |
min_usd | number | Importe mínimo de la operación, $ |
insider | boolean | true — solo operaciones con etiqueta insider |
curl -G "https://api.genesisarbitrage.com/v1/predictions/trades" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d period=today -d side=buy -d min_usd=10000
{
"ts": 1794675812,
"wallet": "0x3a1c…f09e",
"tags": ["whale", "smart"],
"title": "Will Bitcoin reach $150k in 2026?",
"outcome": "No",
"side": "buy",
"price": 0.82,
"shares": 30487.8,
"usd": 25000,
"role": "taker",
"insider": false,
"bid_now": 0.81,
"ask_now": 0.83
}
usd = price × shares: 0,82 × 30.487,8 ≈ 25.000. bid_now y ask_now son los precios actuales del resultado: seguir esta operación ahora cuesta 0,83, 1 ¢ más de lo que pagó el trader.
/predictions/traders da el PnL de todo el tiempo, de 30 y de 7 días (pnl_usd), roi_pct, won de resolved y el minigráfico pnl_series. Pon una dirección del ranking en el wallet de la cinta de operaciones.
Cómo usarlo
Comprueba tu plan y las plataformas
/account/usagemuestra tu plan,/predictions/platforms— cuán frescas son las cotizaciones.Pide paquetes con filtros
min_profit_pctymax_daysrecortan el ruido y los paquetes a largo plazo.Revisa los riesgos y las reglas
Con
rules_differ, lee las reglas de liquidación de ambas plataformas.Consulta sin superar la frescura de tu plan
Usa un intervalo de al menos
meta.freshness_secy devuelve elETagenIf-None-Match: una respuesta304no consume cuota.Opera tú mismo
Abre el mercado desde
legs[].urly comprueba el precio en su libro de órdenes.
La misma petición exact en Python:
import os
from datetime import datetime, timezone
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
params = {"mode": "exact", "min_profit_pct": 1, "max_days": 30}
r = requests.get(f"{API}/predictions/arbitrage", headers=HEADERS,
params=params, timeout=10)
if r.status_code == 403:
raise SystemExit("Endpoint or mode is not part of your API plan")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"Bundles: {body['meta']['count']}, data as of {ts:%H:%M:%S} UTC")
for b in body["data"]:
print(f"{b['profit_pct']:.2f}% · ${b['profit_usd']:.2f} · "
f"{b['days_left']:.0f} d · {b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']}: {leg['side']} "
f"{leg['outcome']} at {leg['price_avg']}")
if b["risks"]:
print(" risks:", ", ".join(b["risks"]))
En el sitio, estos mismos paquetes se explican en las guías Arbitraje de predicción y Modo Sport; las API oficiales de las plataformas, en los artículos sobre las API de Polymarket y Kalshi y sobre las cuotas de apuestas por API.
Preguntas y respuestas
¿Puedo comprar contratos o hacer apuestas a través de Genesis API?
No. Genesis API solo lee datos y no envía órdenes: operas y apuestas tú mismo en las plataformas.
¿Por qué profit_usd es null en una surebet?
Al menos una pata es una apuesta a cuota y la plataforma no publica su límite de apuesta. El porcentaje de beneficio se conoce; calcula el importe de cada pata a partir de stake_unit.
¿La API incluye surebets en vivo?
No, solo prepartido. Por qué el directo es más arriesgado se explica en el artículo sobre prepartido frente a en vivo.
¿Qué plan necesito para las surebets?
Pro o Max: en Start, mode=sport devuelve 403 plan_restricted. Los precios están en la página Precios de Genesis API.