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:
- Consigue una clave —
POST https://oddsbunch.com/api/data/v1/keyscon{"accept_notice": true}. Sin registro. La clave (obd_…) se muestra una sola vez. - Elige el alcance —
GET /meta/sports,/meta/leagues?sport=soccery/matches?league=…devuelven nuestros ID. - Mira el coste y luego pide —
GET /quote?league=…te dice, sin cobrar, cuántos partidos nuevos se cobrarían. DespuésGET /odds?league=…y, a partir de ahí, añadesince=<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 -20import os, time, requests
BASE = "https://oddsbunch.com/api/data/v1"
def get_key():
# Free key, no sign-up. Store it safely; it cannot be shown again.
r = requests.post(f"{BASE}/keys", json={"accept_notice": True}, timeout=30)
r.raise_for_status()
return r.json()["data"]["key"]
KEY = os.environ.get("ODDSBUNCH_KEY") or get_key()
S = requests.Session()
S.headers["Authorization"] = f"Bearer {KEY}" # requests sends Accept-Encoding: gzip by default
class CursorExpired(Exception):
pass
def call(path, **params):
while True:
r = S.get(f"{BASE}{path}", params=params, timeout=30)
if r.status_code == 429: # rate limited
time.sleep(int(r.headers.get("Retry-After", "60")))
continue
body = r.json()
if r.status_code == 410: # cursor_expired: start over without since
raise CursorExpired()
if r.status_code == 401: # key_missing / key_invalid / key_revoked
raise SystemExit(f"Key problem: {body['error']} -> {body['fix']}")
if r.status_code == 402: # payment_required / over_budget
raise SystemExit(f"{body['error']}: {body['message']} -> {body['fix']}")
if not body.get("ok"):
raise RuntimeError(f"{body['error']}: {body['message']} ({body['docs']})")
return body
def fetch_all(**params):
"""All pages of one request. Every page has the same meta.cursor."""
items, removed, cursor, token = [], [], None, None
while True:
page = call("/odds", **params, **({"page_token": token} if token else {}))
cursor = page["meta"]["cursor"]
items += page["data"]
removed += page.get("data_removed", [])
token = page["meta"]["next_page"]
if not token:
return items, removed, cursor, page["meta"]["tier"]
leagues = call("/meta/leagues", sport="soccer")["data"]
league_id = leagues[0]["id"]
quote = call("/quote", league=league_id)["data"]
print("new matches:", quote["new_matches"], "cost:", quote["cost"], "USDT")
# An agent should ask its human before a large charge (or pass max_charge=…).
seen = set() # de-duplicate lines across deltas
items, _, cursor, tier = fetch_all(league=league_id)
for item in items:
m = item["match"]
print(m["id"], m["home"]["name"], "vs", m["away"]["name"])
while True:
time.sleep(60 if tier == "paid" else 300) # free snapshots are rebuilt every 5 min
try:
items, removed, cursor, tier = fetch_all(league=league_id, since=cursor)
except CursorExpired:
items, removed, cursor, tier = fetch_all(league=league_id) # start over (all pages)
for item in items:
for mk in item["markets"]:
for ln in mk["lines"]:
for b in ln["books"]:
k = (item["match"]["id"], b["bookmaker"], mk["market"], ln["line"], b["changed_at"])
if k not in seen:
seen.add(k)
print("changed:", k)
for r in removed:
print("removed:", r["id"], r["reason"])const BASE = "https://oddsbunch.com/api/data/v1";
async function getKey() {
// Free key, no sign-up (call from a server or a terminal). Store it safely; it cannot be shown again.
const r = await fetch(`${BASE}/keys`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ accept_notice: true }),
});
if (!r.ok) throw new Error(`key: HTTP ${r.status}`);
return (await r.json()).data.key;
}
const KEY = process.env.ODDSBUNCH_KEY || (await getKey());
const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
class CursorExpired extends Error {}
async function call(path, params = {}) {
const url = `${BASE}${path}?${new URLSearchParams(params)}`;
for (;;) {
const r = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } }); // fetch handles gzip
if (r.status === 429) { await sleep(1000 * Number(r.headers.get("Retry-After") || 60)); continue; }
const body = await r.json();
if (r.status === 410) throw new CursorExpired();
if (r.status === 401) throw new Error(`Key problem: ${body.error} -> ${body.fix}`);
if (r.status === 402) throw new Error(`${body.error}: ${body.message} -> ${body.fix}`);
if (!body.ok) throw new Error(`${body.error}: ${body.message} (${body.docs})`);
return body;
}
}
async function fetchAll(params) {
// All pages of one request share meta.cursor; use it only after the last page.
let items = [], removed = [], token = null, page;
do {
page = await call("/odds", token ? { ...params, page_token: token } : params);
items = items.concat(page.data);
removed = removed.concat(page.data_removed || []);
token = page.meta.next_page;
} while (token);
return { items, removed, cursor: page.meta.cursor, tier: page.meta.tier };
}
const leagues = (await call("/meta/leagues", { sport: "soccer" })).data;
const league = leagues[0].id;
const quote = (await call("/quote", { league })).data;
console.log("new matches:", quote.new_matches, "cost:", quote.cost, "USDT");
let res = await fetchAll({ league });
console.log(res.items.length, "matches");
for (;;) {
await sleep(res.tier === "paid" ? 60_000 : 300 * 1000);
try {
res = await fetchAll({ league, since: res.cursor });
} catch (e) {
if (!(e instanceof CursorExpired)) throw e;
res = await fetchAll({ league }); // start over (all pages)
}
for (const item of res.items) console.log("changed:", item.match.id);
for (const r of res.removed) console.log("removed:", r.id, r.reason);
}
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,marketsymain_onlysolo 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 con402 over_budgety 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, recibes402 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:
| Campo | Significado |
|---|---|
| changed_at | Cuándo cambió este precio por última vez (UTC). |
| seen_at | Cuándo lo confirmamos por última vez en nuestra recogida. |
| age_sec | Segundos de changed_at a meta.generated_at (se calcula al construir la respuesta). |
| suspended | true 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.
| Deporte | Mediana | Percentil 90 |
|---|---|---|
| Fútbol | 42 s | 75 s |
| Hockey sobre hielo | 39 s | 174 s |
| Esports | 43 s | 67 s |
| Baloncesto | 58 s | — |
| Fútbol americano | 64 s | 168 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_…"
}
| HTTP | error | Qué hacer |
|---|---|---|
| 400 | bad_scope | La respuesta enumera los parámetros permitidos. Corrige la consulta. |
| 400 | bad_param | Un valor de parámetro es incorrecto; invalid indica cuál. |
| 400 | notice_required | Envía "accept_notice": true (lee antes GET /notice). |
| 400 | scope_required_free | Las claves gratuitas deben elegir un alcance (ids, sport, league o team). |
| 400 | bad_json | Envía JSON válido. |
| 401 | key_missing · key_invalid | Consigue una clave con POST /keys o revisa la cabecera. |
| 401 | key_revoked | La clave fue revocada (reason). Usa otra clave de la misma cuenta; no crees una cuenta nueva. |
| 402 | payment_required | Recarga (POST /account/topup) o reduce el alcance. |
| 402 | over_budget | Supera max_charge o tu límite de gasto mensual; no se cobró nada. Sube el límite, reduce el alcance o usa buy=false. |
| 402 | addon_required | Compra la suscripción de 30 días (POST /addons/arbs). |
| 403 | suspended | El acceso a la API de esta cuenta está suspendido. Escribe a support@oddsbunch.com. |
| 403 | not_on_sale | Las funciones de pago no están abiertas (aún, o la venta está en pausa: lo que ya compraste sigue funcionando). |
| 403 | bad_origin | Crea claves y recupera desde un servidor o una terminal, no desde la página de otro sitio. |
| 404 | not_found | No existe esa ruta o partido, o ya empezó sin haberlo recibido antes. |
| 409 | key_limit_account · last_key · ambiguous_hint | Demasiadas 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). |
| 410 | cursor_expired | Vuelve a pedirlo sin since (todas las páginas) y sigue con el nuevo cursor. |
| 413 · 415 | body_too_large · unsupported_media | Mantén los cuerpos JSON por debajo de 16 KB y envía Content-Type: application/json. |
| 429 | rate_limited | Espera Retry-After segundos (limit_kind dice qué límite). |
| 429 | free_daily_limit | Se acabaron los partidos gratuitos de hoy; los que ya tienes siguen funcionando. Se reinicia en resets_at (00:00 UTC). |
| 429 | key_limit_ip | Demasiadas claves nuevas desde esta IP hoy; usa la que tienes. |
| 500 | server | Reintenta espaciando las peticiones. |
| 503 | unavailable | Reintenta pasados Retry-After segundos. |
Límites
| Clave gratuita | Clave de pago | |
|---|---|---|
| Peticiones | 100 por hora para cuotas, partidos y resultados; 300 por hora para meta, presupuesto, cuenta y aviso | 120 por minuto; peticiones completas (no delta) del mismo alcance 2 por minuto |
| Partidos | 20 partidos nuevos por día UTC | sin cuenta diaria (cobro por partido, con tope mensual) |
| Datos | instantánea con 5–10 minutos de retraso, líneas principales | lo más reciente (sin retraso añadido), todas las líneas |
| Complementos | solo el historial del modelo | cuotas propias, suscripción de arbitrajes, cuotas de cierre |
| Claves | 3 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.
/keys
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
/meta/sports
Active sports
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| lang | string (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
/meta/leagues
Active leagues (ids for scopes)
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| lang | string (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
/meta/bookmakers
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
/meta/markets
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
/matches
Fixtures, status, scores (no odds)
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| status | string | – | 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
/results
Finished scores
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/odds
Odds for not-yet-started matches in scope
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| since | string | – | Cursor from meta.cursor (delta) |
| changes_only | boolean | – | In a delta, only changed lines |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/odds/{match_id}
One match, everything
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| match_id (path) | integer | * | |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (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
/quote
Cost preview, no charge
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| product | string (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
/model
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)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/model/{match_id}
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)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| match_id (path) | integer | * | |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (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
/model/scorecard
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
/arbs
Arbitrage list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_payout | number | – |
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
/middles
Middles list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_miss | number | – |
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
/spreads
Price gaps
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| outcome | string | – | |
| min_pct | number | – |
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
/closing
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)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/account
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
/account/passes
Passes of the account
Not open yet (403 not_on_sale until paid access opens). Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| month | string | – | |
| kind | string | – | |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/account/budget
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
/account/topup
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
/addons/arbs
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
/keys/rotate
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
/keys/{hint}
Revoke a key by its last 4 characters
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| hint (path) | string | * | |
| confirm | string (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
/account/link-email
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
/account/link-email/verify
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
/account/link-email/old-code
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
/account/link-email
Unlink the recovery email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"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
/account/recover
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
/account/recover/verify
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
/account/refund-address
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
/notice
Notice text (5 languages)
Billing: free
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| lang | string (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)
- Estos datos son solo informativos. No garantizamos su exactitud, integridad ni puntualidad.
- 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.
- 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.
- 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.
- 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.