Cuotas Pinnacle de un equipo por nombre
Respuesta: añade q= a /v1/odds (o a /v1/events). Es una búsqueda de subcadena, sin distinguir mayúsculas, sobre el equipo local, el visitante y el nombre de la liga, así que q=arsenal devuelve todos los partidos del Arsenal en el deporte que indiques, cada uno con sus mercados. En /v1/odds el parámetro sport es obligatorio. Funciona en todos los planes, también Free (30 s de retraso y solo mercados principales).
curl#
curl -s "https://pinnfeed.io/v1/odds?sport=soccer&q=arsenal&market=moneyline&main=true" \
-H "x-api-key: ps_live_your_key"
La respuesta es {count, offset, limit, events: [...]}. Cada evento trae id, home, away, league {id, name, group}, startTime, live y un array markets con outcomes (decimal, american, fair, fairProb) más margin y maxStake.
Python: solo el próximo partido#
import os, requests
KEY = os.environ["PINNFEED_KEY"] # ps_live_...
r = requests.get(
"https://pinnfeed.io/v1/odds",
params={"sport": "soccer", "q": "arsenal", "market": "moneyline", "main": "true"},
headers={"x-api-key": KEY},
timeout=10,
)
r.raise_for_status()
events = r.json()["events"] # sorted by start time, current events first
if events:
ev = events[0]
for m in ev["markets"]:
prices = {o["name"]: o["decimal"] for o in m["outcomes"]}
print(ev["home"], "v", ev["away"], ev["startTime"], prices, "maxStake", m["maxStake"])
Consejos#
- Sé específico.
q=unitedcoincide con varios clubes y con ligas que llevan "United" en el nombre. Compruebahome/awayen tu código o usa eliddel evento:/v1/events/{id}. - También busca en ligas.
q=ligadevuelve eventos cuya liga contiene "Liga". Para un filtro estable usa el id de liga (league=). - Los nombres son los de Pinnacle. No hay mapeo de equipos entre casas.
- Push para un partido. En Builder, suscríbete al WebSocket con
"events":[id]en lugar de hacer polling.
Planes#
Free: 2 deportes, 1 req/s, 1.000 peticiones al día, 30 s de retraso. Builder (€99/mes) añade push en tiempo real por WebSocket, los 13 deportes y todos los mercados. Prueba de 3 días; se requiere tarjeta y se cobra después del día 3 salvo que canceles. Clave gratis · docs.
Contenido educativo para mayores de 18 años.
Preguntas frecuentes#
¿La búsqueda es aproximada?#
No. Es una coincidencia literal de subcadena sin distinguir mayúsculas. "Man Utd" no encuentra "Manchester United".
¿Puedo buscar en todos los deportes?#
/v1/events?q=... funciona sin deporte y busca en todos los deportes de tu plan (eventos, sin precios). /v1/odds necesita sport.
¿Devuelve partidos terminados?#
No. Solo eventos que Pinnacle tiene publicados ahora. Para precios de cierre en Builder: cuotas de cierre.