Referencia de la API de datos de cuotas

Endpoints, cobro, frescura y errores en una página. La documentación para máquinas dice lo mismo.

Para máquinas: openapi.json · docs.md · llms.txt

Primeros pasos

Tres pasos:

  1. Consigue una clave — POST https://oddsbunch.com/api/data/v1/keys con {"accept_notice": true}. Sin registro. La clave (obd_…) se muestra una sola vez.
  2. Elige el alcance — GET /meta/sports, /meta/leagues?sport=soccer y /matches?league=… devuelven nuestros ID.
  3. Mira el coste y luego pide — GET /quote?league=… te dice, sin cobrar, cuántos partidos nuevos se cobrarían. Después GET /odds?league=… y, a partir de ahí, añade since=<meta.cursor> para recibir solo los partidos que cambiaron.

El acceso de pago aún no está abierto; por ahora todas las claves son gratuitas.

Regla de coste: partidos nuevos × 0.03 USDT, nunca más de 49 USDT por mes natural UTC. Un partido que ya tienes no se vuelve a cobrar hasta el inicio.

Las claves gratuitas reciben una instantánea con 5–10 minutos de retraso, solo líneas principales, 20 partidos al día y 100 peticiones por hora, y deben elegir un alcance (ids, sport, league o team). Para explorar, limit=5&main_only=true&markets=1x2 es ligero. URL base: https://oddsbunch.com/api/data/v1.

Páginas y deltas: sigue meta.next_page hasta que sea null; todas las páginas llevan el mismo meta.cursor, y ese cursor se usa en la siguiente llamada con since solo después de recibir todas las páginas. Con 410 cursor_expired, vuelve a pedirlo todo (todas las páginas) sin since.

BASE="https://oddsbunch.com/api/data/v1"

# 1) Free key, no sign-up (read GET $BASE/notice first). The key is shown once — save it.
curl -s -X POST "$BASE/keys" -H "Content-Type: application/json" -d '{"accept_notice": true}'
export ODDSBUNCH_KEY=obd_...   # data.key from the response

AUTH="Authorization: Bearer $ODDSBUNCH_KEY"

# 2) Scope: leagues of a sport (our IDs)
curl -s --compressed -H "$AUTH" "$BASE/meta/leagues?sport=soccer"

# 3) Cost preview (no charge), then fetch — follow meta.next_page until null (all pages share one cursor)
curl -s --compressed -H "$AUTH" "$BASE/quote?league=386"
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386" -o page1.json
CURSOR=$(jq -r '.meta.cursor' page1.json); NEXT=$(jq -r '.meta.next_page // empty' page1.json)
while [ -n "$NEXT" ]; do
  curl -s --compressed -H "$AUTH" "$BASE/odds?league=386&page_token=$NEXT" -o next.json
  NEXT=$(jq -r '.meta.next_page // empty' next.json)
done

# 4) Deltas: only matches changed since the cursor (after taking all pages)
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386&since=$CURSOR"

# Errors: -i shows the status; on 429 read Retry-After, on 410 fetch again without since
curl -si --compressed -H "$AUTH" "$BASE/odds?league=386" | head -20

Autenticación

Envía la clave en una de estas dos cabeceras: Authorization: Bearer obd_… o X-API-Key: obd_…. Nunca en la URL. Solo guardamos un hash de la clave, así que una clave perdida no se puede volver a mostrar: si vinculaste un correo, recupera la cuenta con POST /account/recover; si no, consigue una clave gratuita nueva (una clave nueva es una cuenta nueva: los partidos comprados y el saldo no se trasladan). Para sustituir una clave en uso llama a POST /keys/rotate (la clave con la que llamas se revoca salvo que envíes "keep_old": true); DELETE /keys/{hint} revoca una clave. Una clave revocada responde 401 key_revoked con un reason: usa otra clave de la misma cuenta en lugar de crear una nueva. Las claves de una misma cuenta comparten todo lo que has pagado. Los endpoints de lectura envían Access-Control-Allow-Origin: *, así que el código del navegador puede llamarlos; crear claves y recuperar no (hazlo desde un servidor o una terminal). No incluyas una clave de pago en una página web pública.

Cobro y tope mensual

El acceso de pago aún no está abierto; por ahora todas las claves son gratuitas.

  • Cuotas: la primera vez que tu cuenta recibe un partido se cobra 0.03 USDT una sola vez. Después, todas las claves de la cuenta pueden pedir ese partido (todas las casas, mercados y líneas) tantas veces como permita el límite de peticiones hasta el inicio; las cuotas de cierre y el resultado tras el inicio están incluidos.
  • Tope mensual: cuando los cobros de cuotas de los partidos que empiezan en un mes natural UTC llegan a 49 USDT, no se cobra nada más por los partidos de ese mes. El tope sigue el mes en que el partido empieza, así que los partidos del mes siguiente cuentan para el tope del mes siguiente. Una petición que cruza el tope solo paga lo que falta.
  • Filtros: bookmakers, markets y main_only solo reducen la respuesta y no cambian el precio. No se cobra un partido que tus filtros dejan vacío ni uno sin cuotas (skipped: filtered_out / no_odds).
  • Límites que controlas: max_charge=<USDT> en una petición, buy=false (solo partidos que ya tienes) y un límite de gasto mensual para todos los productos (POST /account/budget). Una petición que los supere se rechaza con 402 over_budget y no se cobra nada.
  • Complementos: cuotas propias +0.01 USDT por partido (tope 9); suscripción de 30 días a arbitrajes/middles/diferencias 5 USDT; historial de cuotas de cierre 0.01 USDT por partido terminado (fuera del tope).
  • Saldo insuficiente: los partidos que ya tienes se siguen devolviendo; los nuevos que no puedes pagar se dejan fuera y sus ID aparecen en billing.unpaid_matches (HTTP 200). Si todos los partidos pedidos son nuevos y no se pueden pagar, recibes 402 payment_required. Nunca cambiamos en silencio una cuenta de pago a datos con retraso.
  • Cada respuesta lleva billing: charged, new_matches, balance, month_spent, month_cap, free_left_today.
  • USDT prepago: recarga con POST /account/topup (BSC o TRON, mínimo 10 USDT). El saldo de una cuenta creada solo con una clave no se puede retirar. Si compraste un partido, o este empezó, mientras nuestra recogida estaba parada y sus cuotas no se actualizaron durante la parada (compraste datos congelados), el cobro de cuotas se devuelve automáticamente tras el inicio (no las cuotas propias ni las de cierre); un partido devuelto queda anulado (pedirlo otra vez se cobra otra vez) y el importe deja de contar para el tope. Los partidos cancelados también se devuelven; los aplazados conservan el mismo ID y siguen contando como ya recibidos.
  • Subir precios o el tope, o bajar los límites gratuitos o de peticiones, se aplica el primer día 1 de un mes que llegue al menos 7 días después del aviso; los cambios a tu favor se aplican al momento.

Campos de frescura

Cada línea de cuotas lleva cuatro campos para que tu código decida qué está demasiado viejo:

CampoSignificado
changed_atCuándo cambió este precio por última vez (UTC).
seen_atCuándo lo confirmamos por última vez en nuestra recogida.
age_secSegundos de changed_at a meta.generated_at (se calcula al construir la respuesta).
suspendedtrue si la casa ha retirado la línea; se conserva el último valor.

El fútbol y el fútbol americano se reciben de forma incremental, así que en una línea sin cambios seen_at puede ir hasta 10 minutos por detrás; usa changed_at/age_sec para medir la antigüedad. book_marked_main es la línea que la casa marca como principal; main en un grupo de líneas es la línea representativa que elegimos. Los campos en porcentaje terminan en _pct (p. ej. combined_payout_pct); roi es una proporción. Las claves gratuitas reciben una instantánea que se rehace cada 5 minutos y solo se sirve cuando tiene al menos 5 minutos, así que meta.delay_sec está entre 300 y algo más del doble. Las combinaciones de arbitraje también dan la antigüedad de cada pata y de la pata más antigua y, para las de 105 % o más, un estado verify: same (coincide con el precio en vivo de la casa), diff, unverifiable o pending.

Latencia medida

Tiempo desde la actualización de la propia casa hasta nuestro changed_at, medido con datos recientes. Lo normal es alrededor de un minuto; a veces varios minutos.

DeporteMedianaPercentil 90
Fútbol42 s75 s
Hockey sobre hielo39 s174 s
Esports43 s67 s
Baloncesto58 s—
Fútbol americano64 s168 s

Medido 2026-11-18 · últimas 2 horas · hora de actualización de la casa → nuestra hora de actualización

Errores

Los errores siempre tienen esta forma, para que un agente pueda recuperarse sin una persona:

{
  "ok": false,
  "error": "payment_required",
  "message": "Balance 0.01 USDT is below the 0.03 USDT needed for 1 new match.",
  "fix": "Top up with POST /account/topup, or narrow the scope (ids=…).",
  "docs": "https://oddsbunch.com/api/data/v1/docs.md#errors",
  "docs_html": "https://oddsbunch.com/en/api/docs#errors",
  "request_id": "r_…"
}
HTTPerrorQué hacer
400bad_scopeLa respuesta enumera los parámetros permitidos. Corrige la consulta.
400bad_paramUn valor de parámetro es incorrecto; invalid indica cuál.
400notice_requiredEnvía "accept_notice": true (lee antes GET /notice).
400scope_required_freeLas claves gratuitas deben elegir un alcance (ids, sport, league o team).
400bad_jsonEnvía JSON válido.
401key_missing · key_invalidConsigue una clave con POST /keys o revisa la cabecera.
401key_revokedLa clave fue revocada (reason). Usa otra clave de la misma cuenta; no crees una cuenta nueva.
402payment_requiredRecarga (POST /account/topup) o reduce el alcance.
402over_budgetSupera max_charge o tu límite de gasto mensual; no se cobró nada. Sube el límite, reduce el alcance o usa buy=false.
402addon_requiredCompra la suscripción de 30 días (POST /addons/arbs).
403suspendedEl acceso a la API de esta cuenta está suspendido. Escribe a support@oddsbunch.com.
403not_on_saleLas funciones de pago no están abiertas (aún, o la venta está en pausa: lo que ya compraste sigue funcionando).
403bad_originCrea claves y recupera desde un servidor o una terminal, no desde la página de otro sitio.
404not_foundNo existe esa ruta o partido, o ya empezó sin haberlo recibido antes.
409key_limit_account · last_key · ambiguous_hintDemasiadas claves activas (revoca una) · última clave de una cuenta sin correo (?confirm=lose_account solo si de verdad lo quieres y el saldo es 0) · dos claves comparten esos 4 caracteres (rota una).
410cursor_expiredVuelve a pedirlo sin since (todas las páginas) y sigue con el nuevo cursor.
413 · 415body_too_large · unsupported_mediaMantén los cuerpos JSON por debajo de 16 KB y envía Content-Type: application/json.
429rate_limitedEspera Retry-After segundos (limit_kind dice qué límite).
429free_daily_limitSe acabaron los partidos gratuitos de hoy; los que ya tienes siguen funcionando. Se reinicia en resets_at (00:00 UTC).
429key_limit_ipDemasiadas claves nuevas desde esta IP hoy; usa la que tienes.
500serverReintenta espaciando las peticiones.
503unavailableReintenta pasados Retry-After segundos.

Límites

Clave gratuitaClave de pago
Peticiones100 por hora para cuotas, partidos y resultados; 300 por hora para meta, presupuesto, cuenta y aviso120 por minuto; peticiones completas (no delta) del mismo alcance 2 por minuto
Partidos20 partidos nuevos por día UTCsin cuenta diaria (cobro por partido, con tope mensual)
Datosinstantánea con 5–10 minutos de retraso, líneas principaleslo más reciente (sin retraso añadido), todas las líneas
Complementossolo el historial del modelocuotas propias, suscripción de arbitrajes, cuotas de cierre
Claves3 claves nuevas por IP y día—

No consultes más rápido de lo que cambian los datos: cada 60 segundos aprox. con claves de pago, cada 5 minutos con claves gratuitas. Usa since para que cada consulta devuelva solo los partidos que cambiaron.

Endpoints

Generado a partir de la especificación OpenAPI (openapi.json). Cada tarjeta muestra el tipo de cobro, los parámetros y una respuesta de ejemplo.

POST /keys Gratis

Free key without sign-up

Billing: free

JSON body
{
  "accept_notice": true,
  "label": "string",
  "lang": "string",
  "via": "page"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "key": "string",
    "key_hint": "string",
    "shown_once": true,
    "tier": "string",
    "limits": {
      "delay_sec": 0,
      "delay_max_sec": 0,
      "daily_matches": 0,
      "hourly_requests": 0,
      "light_hourly_requests": 0,
      "main_lines_only": true,
      "scope_required": true
    },
    "notice": {
      "version": "string",
      "url": "string",
      "summary": [
        "string"
      ]
    },
    "warning": "string",
    "next": [
      {
        "do": "string",
        "request": "string"
      }
    ],
    "docs": {
      "openapi": "string",
      "markdown": "string",
      "human": "string"
    },
    "revoked_hint": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/sports Gratis

Active sports

Billing: free

Parámetros
NombreTipoObligatorioDescripción
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/leagues Gratis

Active leagues (ids for scopes)

Billing: free

Parámetros
NombreTipoObligatorioDescripción
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "id": 0,
      "sport": "string",
      "name": "string",
      "name_en": "string",
      "country": "string",
      "upcoming_7d": 0
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/bookmakers Gratis

Bookmaker slugs

Billing: free

Sin parámetros

Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/markets Gratis

Markets, outcomes, period, line_step

Billing: free

Sin parámetros

Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /matches Gratis

Fixtures, status, scores (no odds)

Billing: free

Parámetros
NombreTipoObligatorioDescripción
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
fromstring–UTC date or date-time
tostring–UTC date or date-time
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
statusstring–scheduled,live,finished,other
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /results Gratis

Finished scores

Billing: free

Parámetros
NombreTipoObligatorioDescripción
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
datestring–UTC day YYYY-MM-DD
fromstring–UTC date or date-time
tostring–UTC date or date-time
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /odds Por partido · 0.03 USDT

Odds for not-yet-started matches in scope

Billing: odds pass per new match (0.03 USDT, monthly cap 49)

Parámetros
NombreTipoObligatorioDescripción
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
hoursinteger–Matches starting within N hours (default 168)
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
sincestring–Cursor from meta.cursor (delta)
changes_onlyboolean–In a delta, only changed lines
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "pass": "odds",
      "source": "live",
      "markets": [
        {
          "market": "…",
          "lines": "…"
        }
      ]
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /odds/{match_id} Por partido · 0.03 USDT

One match, everything

Billing: odds pass per new match (0.03 USDT, monthly cap 49)

Parámetros
NombreTipoObligatorioDescripción
match_id (path)integer*
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "match": {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    },
    "pass": "odds",
    "source": "live",
    "markets": [
      {
        "market": "1x2",
        "lines": [
          "…"
        ]
      }
    ]
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /quote Gratis

Cost preview, no charge

Billing: free

Parámetros
NombreTipoObligatorioDescripción
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
hoursinteger–Matches starting within N hours (default 168)
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
productstring (odds | model | closing)–
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "product": "string",
    "tier": "string",
    "matches_in_scope": 0,
    "with_pass": 0,
    "new_matches": 0,
    "price": 0,
    "cost": 0,
    "month": "string",
    "month_spent": 0,
    "month_cap": 0,
    "cap_left": 0,
    "cap_reached_after": true,
    "balance": 0,
    "affordable_matches": 0,
    "would_be_unpaid": 0,
    "budget_month": 0,
    "budget_spent": 0,
    "budget_left": 0,
    "over_budget": true,
    "skipped": {
      "no_odds": 0,
      "filtered_out": 0,
      "started": 0,
      "free_daily_limit": 0
    },
    "free_left_today": 0,
    "if_paid": {},
    "note": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /model Cuotas propias · por partido · 0.01 USDT De pago — próximamente

Model odds (soccer 1X2)

Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)

Parámetros
NombreTipoObligatorioDescripción
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "model": "string",
      "market": "string",
      "p": {
        "home": 0,
        "draw": 0,
        "away": 0
      },
      "fair": {
        "home": 0,
        "draw": 0,
        "away": 0
      },
      "basis": "lineup",
      "official": true,
      "computed_at": "string",
      "pre_complete": true,
      "complete": true,
      "history": [
        {
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /model/{match_id} Cuotas propias · por partido · 0.01 USDT De pago — próximamente

Model odds for one match

Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)

Parámetros
NombreTipoObligatorioDescripción
match_id (path)integer*
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "match": {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    },
    "model": "string",
    "market": "string",
    "p": {
      "home": 0,
      "draw": 0,
      "away": 0
    },
    "fair": {
      "home": 0,
      "draw": 0,
      "away": 0
    },
    "basis": "lineup",
    "official": true,
    "computed_at": "string",
    "pre_complete": true,
    "complete": true,
    "history": [
      {
        "p": {},
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /model/scorecard Gratis

Live record of the model

Billing: free

Sin parámetros

Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "model": "string",
    "what": "string",
    "since": "string",
    "updated_at": "string",
    "groups": [
      {
        "basis": "string",
        "data": "complete",
        "n": 0,
        "brier_model": 0,
        "brier_market": 0,
        "diff": 0,
        "se": 0,
        "verdict": "better",
        "virtual_picks": {
          "n": "…",
          "roi": "…"
        }
      }
    ],
    "notes": [
      "string"
    ]
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /arbs Suscripción de 30 días · 5 USDT De pago — próximamente

Arbitrage list

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

Parámetros
NombreTipoObligatorioDescripción
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_payoutnumber–
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "market": "string",
      "line": 0,
      "combined_payout_pct": 0,
      "legs": [
        {
          "outcome": "…",
          "side": "…",
          "line": "…",
          "bookmaker": "…",
          "odds": "…",
          "stake_share_pct": "…",
          "changed_at": "…",
          "age_sec": "…"
        }
      ],
      "oldest_leg_age_sec": 0,
      "stale": true,
      "verify": "string"
    }
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /middles Suscripción de 30 días · 5 USDT De pago — próximamente

Middles list

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

Parámetros
NombreTipoObligatorioDescripción
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_missnumber–
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "market": "string",
      "window": {
        "from": 0,
        "to": 0
      },
      "legs": [
        {
          "outcome": "…",
          "side": "…",
          "line": "…",
          "bookmaker": "…",
          "odds": "…",
          "stake_share_pct": "…",
          "changed_at": "…",
          "age_sec": "…"
        }
      ],
      "miss_payout_pct": 0,
      "hit_payout_pct": 0,
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /spreads Suscripción de 30 días · 5 USDT De pago — próximamente

Price gaps

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

Parámetros
NombreTipoObligatorioDescripción
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
outcomestring–
min_pctnumber–
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "market": "string",
      "outcome": "string",
      "best": {
        "bookmaker": "string",
        "odds": 0,
        "changed_at": "string"
      },
      "median": 0,
      "gap_pct": 0,
      "books": 0
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /closing Por partido terminado · 0.01 USDT De pago — próximamente

Closing odds of finished matches

Not open yet (403 not_on_sale until paid access opens). Billing: closing pass per finished match (0.01 USDT, outside the cap)

Parámetros
NombreTipoObligatorioDescripción
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
datestring–UTC day YYYY-MM-DD
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
Respuesta de ejemplo
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "result": {},
      "markets": [
        {
          "market": "…",
          "lines": "…"
        }
      ],
      "taken_at": "string",
      "source": "string"
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /account Gratis

Balance, spend, caps, passes, keys

Billing: free

Sin parámetros

Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "account": {
      "kind": "anon",
      "tier": "string",
      "status": "string",
      "suspended": true,
      "email_linked": true,
      "created_at": "string",
      "withdrawable": true,
      "paid_enabled": true
    },
    "balance": 0,
    "month": "string",
    "budget": {
      "month_limit": 0,
      "spent": 0,
      "left": 0,
      "budget_month": 0
    },
    "odds": {
      "spent": 0,
      "cap": 0,
      "passes": 0,
      "cap_by_month": [
        {
          "month": "…",
          "spent": "…"
        }
      ],
      "free_today": {
        "used": 0,
        "limit": 0,
        "resets_at": "string"
      }
    },
    "model": {},
    "closing": {},
    "addons": [
      {
        "product": "arbs",
        "status": "string",
        "starts_at": "string",
        "ends_at": "string",
        "auto_renew": true,
        "charged": 0,
        "changed": "string"
      }
    ],
    "keys": [
      {
        "hint": "string",
        "label": "string",
        "created_at": "string",
        "last_used_at": "string",
        "current": true
      }
    ],
    "topup": {
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /account/passes Gratis De pago — próximamente

Passes of the account

Not open yet (403 not_on_sale until paid access opens). Billing: free

Parámetros
NombreTipoObligatorioDescripción
monthstring–
kindstring–
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/budget Gratis De pago — próximamente

Monthly spending limit

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "budget_month": 0
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "month_limit": 0,
    "spent": 0,
    "left": 0,
    "budget_month": 0
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/topup Gratis De pago — próximamente

Deposit addresses (prepaid USDT)

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "accept_notice": true,
  "network": "bsc"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "on_sale": true,
    "min": 0,
    "networks": [
      "string"
    ],
    "addresses_issued": true,
    "pending": [
      {}
    ],
    "not_credited": [
      {
        "network": "string",
        "amount": 0,
        "seen_at": "string",
        "reason": "string"
      }
    ],
    "not_credited_total": 0,
    "addresses": [
      {
        "network": "string",
        "token": "string",
        "address": "string",
        "confirmations": 0,
        "confirmation": "string",
        "watch_until": "string"
      }
    ],
    "below_min": "string",
    "credit": "string",
    "withdraw_note": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /addons/arbs Suscripción de 30 días · 5 USDT De pago — próximamente

30-day arbs subscription

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

JSON body
{
  "auto_renew": true
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "product": "arbs",
    "status": "string",
    "starts_at": "string",
    "ends_at": "string",
    "auto_renew": true,
    "charged": 0,
    "changed": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /keys/rotate Gratis

New key for the same account

Billing: free

JSON body
{
  "label": "string",
  "keep_old": true
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "key": "string",
    "key_hint": "string",
    "shown_once": true,
    "tier": "string",
    "limits": {
      "delay_sec": 0,
      "delay_max_sec": 0,
      "daily_matches": 0,
      "hourly_requests": 0,
      "light_hourly_requests": 0,
      "main_lines_only": true,
      "scope_required": true
    },
    "notice": {
      "version": "string",
      "url": "string",
      "summary": [
        "string"
      ]
    },
    "warning": "string",
    "next": [
      {
        "do": "string",
        "request": "string"
      }
    ],
    "docs": {
      "openapi": "string",
      "markdown": "string",
      "human": "string"
    },
    "revoked_hint": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

DELETE /keys/{hint} Gratis

Revoke a key by its last 4 characters

Billing: free

Parámetros
NombreTipoObligatorioDescripción
hint (path)string*
confirmstring (lose_account)–
Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/link-email Gratis De pago — próximamente

Recovery email (sends a code)

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "email": "string"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/link-email/verify Gratis De pago — próximamente

Confirm the recovery email

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "code": "string",
  "old_code": "string"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/link-email/old-code Gratis De pago — próximamente

Code to the currently linked email

Not open yet (403 not_on_sale until paid access opens). Billing: free

Sin parámetros

Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/recover Gratis De pago — próximamente

Start recovery with the linked email

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "email": "string"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/recover/verify Gratis De pago — próximamente

Finish recovery (new key)

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "email": "string",
  "code": "string",
  "accept_notice": true,
  "label": "string"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "key": "string",
    "key_hint": "string",
    "shown_once": true,
    "tier": "string",
    "limits": {
      "delay_sec": 0,
      "delay_max_sec": 0,
      "daily_matches": 0,
      "hourly_requests": 0,
      "light_hourly_requests": 0,
      "main_lines_only": true,
      "scope_required": true
    },
    "notice": {
      "version": "string",
      "url": "string",
      "summary": [
        "string"
      ]
    },
    "warning": "string",
    "next": [
      {
        "do": "string",
        "request": "string"
      }
    ],
    "docs": {
      "openapi": "string",
      "markdown": "string",
      "human": "string"
    },
    "revoked_hint": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/refund-address Gratis De pago — próximamente

Refund address during a shutdown notice

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "chain": "bsc",
  "address": "string"
}
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "chain": "bsc",
    "address": "string",
    "ends_at": "string",
    "fallback": "string",
    "note": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /notice Gratis

Notice text (5 languages)

Billing: free

Parámetros
NombreTipoObligatorioDescripción
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
Respuesta de ejemplo
{
  "ok": true,
  "data": {
    "version": "string",
    "lang": "string",
    "short": [
      "string"
    ],
    "items": [
      "string"
    ],
    "terms_url": "string",
    "docs_url": "string",
    "measured_delay": [
      {
        "sport": "string",
        "p50_sec": 0,
        "p90_sec": 0
      }
    ]
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
…

Respuestas de error: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

Aviso (exactitud, retrasos, responsabilidad)

  1. Estos datos son solo informativos. No garantizamos su exactitud, integridad ni puntualidad.
  2. Las cuotas pueden diferir de las que muestra la propia casa de apuestas y llegar tarde o faltar por los intervalos de recogida o por problemas de red. Normalmente reflejan la actualización de la casa en alrededor de un minuto, pero a veces tardan varios minutos (las mediciones por deporte están en la documentación). Usa los campos changed_at, seen_at y age_sec de cada línea para descartar tú mismo los precios desactualizados.
  3. Las combinaciones de arbitraje, los middles y las diferencias de cuota se calculan de forma mecánica a partir de las cuotas recogidas, así que pueden no estar disponibles en realidad por cambios de precio, suspensiones o límites de apuesta de la casa.
  4. Nuestras cuotas propias (oddsbunch-model-v1) son estimaciones hechas con registros de partidos pasados y no garantizan ningún resultado. Publicamos gratis su historial real.
  5. No nos hacemos responsables de las decisiones tomadas con estos datos ni de las pérdidas que de ellas resulten. No revendas los datos ni los redistribuyas a terceros (salvo el uso permitido por el §7-2 de las Condiciones).

Términos §7-2 Uso de la API de datos →

Aceptación: envía "accept_notice": true con POST /keys y POST /account/topup; obtener una clave significa que aceptas este aviso y el §7-2 de los Términos.

Versiones

v1 solo crece: podemos añadir campos, endpoints, valores de enum y códigos de error en cualquier momento; ignora lo que no reconozcas. Los cambios incompatibles (quitar o renombrar un campo, cambiar su significado o un valor por defecto) van a una versión nueva (/api/data/v2), y v1 sigue funcionando al menos 90 días en paralelo, con cabeceras Deprecation y Sunset en sus respuestas. Cada cambio figura en el registro de cambios (docs.md#changelog); meta.api_version indica la versión actual. Los cambios de cobertura (casas, deportes, ligas) no son cambios de versión: consulta /meta/*. Cuando cambia el texto del aviso, las claves nuevas y las recargas vuelven a pedir la aceptación y las claves existentes ven meta.notice_update.