Feed de cuotas de fútbol de Pinnacle
Respuesta: el feed sport=soccer de PinnFeed trae los mercados de fútbol de Pinnacle: moneyline (1X2), spread (hándicap asiático), total de goles y totales por equipo, para cada periodo que Pinnacle cotiza, prepartido y en vivo. Haz polling a GET /v1/odds?sport=soccer en cualquier plan, o recibe cada cambio por WebSocket en Builder (99 €/mes).
REST#
export PINNFEED_KEY="ps_live_..."
curl -sS -H "x-api-key: $PINNFEED_KEY" \
"https://pinnfeed.io/v1/odds?sport=soccer&market=moneyline,spread,total&main=true&limit=50"
Filtra por id de league (lista las ligas con GET /v1/events?sport=soccer), live=true o live=prematch, o q= para un equipo.
WebSocket (Builder)#
{ "type": "subscribe", "sports": ["soccer"], "markets": ["moneyline", "spread", "total"], "main": true }
Recibes subscribed, luego frames snapshot y después frames delta cuando se mueven los precios. El servidor envía ping cada 20 segundos; responde con {"type":"pong"}. Cliente listo: guía WebSocket Python y Node.
Mercados#
- 1X2: moneyline de fútbol
- Apertura y cierre: fútbol apertura/cierre
Planes#
Free: 30 s de retraso, 2 deportes a elegir, mercados principales. Hobby (29 €/mes): REST en tiempo real. Builder: WebSocket, todos los mercados, props e historial de cierres. Planes de pago: prueba de 3 días; se pide tarjeta y se cobra después del día 3 salvo que canceles.
Contenido educativo para mayores de 18 años. Sin pronósticos ni beneficios garantizados.
Filtrar por competición#
Cuando Pinnacle lista una competición, entra en el feed soccer. Busca el id una vez con /v1/events?sport=soccer&q=…, confirma league.name y league.group, y filtra /v1/odds o el WebSocket con ese id. q= es una búsqueda, no una clave única.
| Competición | q= habitual | Atención |
|---|---|---|
| Premier League | premier | Confirma la primera división inglesa en league.name. |
| LaLiga | liga | Muchas ligas contienen "Liga" (Segunda División y otros países). Usa group. Copa del Rey y noches europeas tienen su propio id. Horarios en UTC; convierte a Europe/Madrid. |
| Serie A (Italia) | serie a | Italia y Brasil tienen una Serie A — filtra por id. Serie B y Coppa Italia tienen ids propios. UTC; convierte a Europe/Rome. |
| Bundesliga | bundesliga | También coincide con la segunda alemana y la primera austriaca. La DFB-Pokal es otro id. UTC; convierte a Europe/Berlin. |
| Brasileirão | brazil | No busques solo "Serie A". Serie B, estaduales y Copa do Brasil tienen ids propios. UTC; convierte a America/Sao_Paulo. |
| Champions League | champions | Otras competiciones pueden incluir "Champions". Los outrights del campeón, cuando existen, son specials en Builder y Pro. |
| Ligue 1 | ligue | También coincide con Ligue 2; prueba q=france si no aparece. UTC; convierte a Europe/Paris. |
| MLS | mls | Si no hay resultados, prueba q=usa. Es soccer (1X2 con empate). Horarios en UTC. |
| J-League | japan | J2, J3 y copas pueden salir en la misma búsqueda. Horarios en UTC; convierte a Asia/Tokyo. El hándicap asiático es el mercado spread. |
| Copa Libertadores | libertadores | Las previas pueden ser otro id; la Sudamericana es otra competición. Cada partido de una eliminatoria ida-vuelta es un evento: el 1X2 es de esos 90 minutos, no de quién pasa. |
Reutiliza el id numérico después de confirmarlo. El patrón de código está en la guía en inglés filter by league id.
Preguntas frecuentes#
¿El feed incluye marcadores?#
Los eventos traen score, clock y status cuando Pinnacle los da. PinnFeed es un feed de cuotas, no de estadísticas: sin alineaciones ni datos de jugadores.
¿Qué ligas cubre?#
Las que cotiza Pinnacle. Lístalas con GET /v1/events?sport=soccer.
¿Otras casas?#
No. PinnFeed solo lleva Pinnacle.