La API de liquidación de apuestas que te da el veredicto
Tienes una lista de apuestas y quieres saber cuáles ganaron. Envía el evento, el mercado, la línea y el lado, y recibe ganada, perdida, nula, media ganada o media perdida, calculado a partir del marcador final en 172 mercados de 21 deportes.
Incluida en todos los planes de pago. Cada llamada cuenta como una petición.
- Mercados
- 172
- Deportes
- 21
- Apuestas por petición
- 50
- Endpoints
- 2
Liquida tres apuestas en una sola petición
Este partido terminó 3-2 a los 90 minutos y 3-3 tras la prórroga. En fútbol se liquida a los 90 minutos, así que ganó el moneyline local, y basis muestra el marcador que se usó.
curl -X POST "https://api.odds-api.io/v3/settlements/grade?apiKey=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"selections": [
{ "ref": "bet-1", "eventId": 74919888, "market": "ML", "side": "home" },
{ "ref": "bet-2", "eventId": 74919888, "market": "Spread", "hdp": -0.75, "side": "home" },
{ "ref": "bet-3", "eventId": 74919888, "market": "Totals", "hdp": 5.5, "side": "over" }
]
}'{
"grades": [
{ "ref": "bet-1", "eventId": 74919888, "result": "won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-2", "eventId": 74919888, "result": "half_won", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } },
{ "ref": "bet-3", "eventId": 74919888, "result": "lost", "reason": null, "final": true,
"basis": { "scope": "regulation", "home": 3, "away": 2 } }
]
}Cómo funciona la liquidación de apuestas
Dos endpoints. GET /v3/settlements te dice qué pasó en hasta 50 eventos. POST /v3/settlements/grade te dice si tus apuestas ganaron.
- 1
Guarda la apuesta
Cuando se coloca una apuesta, guarda el id del evento, el mercado, la línea y el lado. Son los mismos cuatro campos que ya recibes de /v3/odds, así que no hay nada que mapear.
- 2
Envíala para liquidar
Tras el partido, haz un POST con hasta 50 selecciones a /v3/settlements/grade. Cada una vuelve como won, lost, void, half_won o half_lost. La mayoría de los mercados de marcador también devuelven el marcador en el que se basa el resultado.
- 3
Liquida cuando el resultado sea definitivo
Cada respuesta lleva un indicador final. Guarda las selecciones con final en false y vuelve a enviarlas más tarde. Con una vez por minuto basta.
Siete respuestas posibles
Solo liquidamos una apuesta cuando el resultado guardado demuestra la respuesta. Si falta algo o los datos no cuadran, recibes ungradeable con un motivo, nunca una suposición.
- won
- La apuesta ganó
- lost
- La apuesta perdió
- half_won
- Línea de cuarto: la mitad del importe gana y la otra mitad se devuelve
- half_lost
- Línea de cuarto: la mitad del importe pierde y la otra mitad se devuelve
- void
- Se devuelve el importe. El motivo es push o event_cancelled
- pending
- Aún no está decidida. El motivo indica qué estamos esperando
- ungradeable
- No podemos demostrar la respuesta. El motivo explica por qué
Reglas de liquidación que puedes leer
Las reglas siguen la práctica habitual de las casas de apuestas. Cada casa difiere en detalles, así que compáralas con tus propias condiciones.
El fútbol se liquida a los 90 minutos
Los mercados de fútbol, fútbol sala, balonmano y rugby se liquidan con el tiempo reglamentario. La prórroga y la tanda de penaltis nunca cuentan, aunque el marcador del partido las incluya.
Prórroga donde las casas la cuentan
En baloncesto, fútbol americano, béisbol y hockey sobre hielo, el moneyline, el spread y los totales incluyen la prórroga y las entradas extra. 3-Way Result, Double Chance, Draw No Bet y los totales y spreads Regulation se liquidan con el tiempo reglamentario.
Las líneas de cuarto dividen el importe
Un hándicap asiático de -0.75 es mitad a -0.5 y mitad a -1. Si el local gana por un gol, la respuesta es half_won. Una línea entera que cae justa es void con motivo push.
Los partidos cancelados son nulos
Toda apuesta sobre un evento cancelado vuelve como void con motivo event_cancelled. Si el partido se reprograma más tarde, el evento vuelve a pending con el mismo id.
Córners y tarjetas a partir de las estadísticas
Los córners, las tarjetas y el primer equipo en marcar del fútbol se liquidan con las estadísticas posteriores al partido, unos 30 minutos después del final. Hasta entonces la respuesta es pending con motivo awaiting_stats.
Props de jugadores a partir del box score
Las props se liquidan en baloncesto, béisbol, hockey sobre hielo y fútbol americano. Identificamos al jugador por su nombre y nos negamos a liquidar si el nombre puede corresponder a dos personas.
172 mercados en 21 deportes
Los nombres de mercado son los que sirve /v3/odds. La guía de liquidación recoge todos los mercados por deporte.
Líneas principales
ML, 3-Way Result, Spread y hándicaps asiáticos, Totals, Team Totals, European Handicap, Double Chance, Draw No Bet, Both Teams To Score, Odd/Even
Mitades, cuartos y entradas
Versiones de primera y segunda mitad de las líneas principales, Half Time / Full Time, cada cuarto en baloncesto y fútbol americano, cada periodo en hockey sobre hielo, y mercados First 5 Innings y 1st Inning en béisbol
Tenis y esports
Hándicap de juegos, total de juegos y juegos por jugador, apuestas a sets, hándicaps de sets, ganadores de set, totales de set y resultado exacto de sets en tenis, voleibol y tenis de mesa. Map Handicap, Total Maps, ganadores de mapa y líneas de rondas y kills por mapa en esports, y líneas de frames en snooker
Estadísticas de fútbol
Córners, tarjetas, totales de tarjetas, tiros a puerta, tiros, paradas del portero, fueras de juego, faltas y entradas, carrera de córners, primer y último córner, primer, último y del 2.º al 5.º equipo en marcar, resultado exacto, margen de victoria, goles exactos y por equipo, ganar sin encajar, portería a cero
Props de jugadores
Líneas de más y menos del box score oficial en baloncesto, béisbol, hockey sobre hielo y fútbol americano
Aún sin liquidar
Mercados de goleador, props de jugadores de fútbol, líneas de dardos, críquet y outrights. Vuelven como unsupported_market
Con qué frecuencia se liquida una apuesta
Pasamos por esta API 22,903 apuestas que nuestro propio bet tracker liquidó en los 30 días hasta el 12 de octubre de 2026. Esta es la proporción que volvió con un veredicto.
- Béisbol, mercados de marcador
- 99.6%
- Hockey sobre hielo, mercados de marcador
- 99.2%
- Baloncesto, mercados de marcador
- 99.1%
- Fútbol americano, mercados de marcador
- 98.5%
- Fútbol, mercados de marcador
- 98.0%
- Tarjetas en fútbol
- 88.3%
- Córners en fútbol
- 82.4%
Toma estas cifras como referencia. Proceden de un mes de apuestas de un solo producto, sobre todo mercados principales de fútbol, en eventos que ya se habían liquidado una vez. El resto volvió como ungradeable con un motivo.
Preguntas frecuentes sobre la API de liquidación de apuestas
¿Cómo liquido apuestas automáticamente con una API?
Guarda el id del evento, el mercado, la línea y el lado cuando se coloca la apuesta. Tras el partido, envíalos a POST /v3/settlements/grade en la API v3 de Odds-API.io. La respuesta indica won, lost, void, half_won o half_lost para cada apuesta, y el indicador final te dice cuándo el resultado está confirmado.
¿Qué es una API de liquidación de apuestas?
Una API de liquidación de apuestas recibe una apuesta que tienes y te dice cómo terminó. Envías el evento, el mercado, la línea y el lado, y te devuelve el resultado a partir del marcador final. La usan bet trackers, plataformas de tipsters, juegos de predicción y back offices de casas de apuestas para no tener que escribir reglas de liquidación para cada mercado y deporte.
¿Qué mercados y deportes puede liquidar la API?
172 mercados en 21 deportes: moneyline, spreads y hándicaps asiáticos, totales, ambos equipos marcan, doble oportunidad, empate no válido, mercados al descanso, juegos y sets de tenis, mapas de esports, córners, tarjetas y orden de goles en fútbol, y props de jugadores en baloncesto, béisbol, hockey sobre hielo y fútbol americano.
¿Puede liquidar apuestas de hándicap asiático con líneas de cuarto?
Sí. Envíalas como Spread con la línea en hdp. El hándicap siempre se expresa para el equipo local. Las líneas de cuarto como -0.75 devuelven half_won o half_lost cuando se devuelve la mitad del importe, y una línea entera que cae justa devuelve void con motivo push.
¿Una apuesta de fútbol se liquida a los 90 minutos o tras la prórroga?
A los 90 minutos más el tiempo añadido. Las apuestas de fútbol, fútbol sala, balonmano y rugby se liquidan con el tiempo reglamentario, aunque el partido haya ido a la prórroga o a los penaltis. En la mayoría de los mercados de marcador, el resultado incluye el marcador en el que se basa, para que puedas mostrárselo a tus usuarios. Half Time / Full Time, córners, tarjetas y props de jugadores devuelven solo el veredicto.
¿Qué pasa si un partido se aplaza o se cancela?
En la mayoría de los casos el estado del evento pasa a cancelled y toda apuesta sobre él se liquida como void con motivo event_cancelled. Si el partido se reprograma más tarde, el evento vuelve a pending con el mismo id. Un partido que nunca obtiene resultado pasa a ungradeable con motivo result_unavailable 72 horas después del inicio.
¿Cuánto tiempo después del partido puedo liquidar una apuesta?
Los mercados de marcador suelen estar listos unos minutos después del pitido final. Córners, tarjetas y props de jugadores tardan unos 30 minutos. Hasta entonces la respuesta es pending. El indicador final pasa a true cuando el resultado se ha contrastado con el oficial, o 48 horas después del final del partido.
¿Qué planes incluyen la API de liquidación?
Los dos endpoints de liquidación están en todos los planes de pago y cada llamada cuenta como una petición. GET /v3/settlements admite hasta 50 ids de evento y POST /v3/settlements/grade admite hasta 50 selecciones.
Deja de escribir reglas de liquidación
La liquidación viene con la misma clave que las cuotas de 450+ casas de apuestas. Elige un plan de pago y envía tus primeras selecciones hoy mismo.