¿Los props están disponibles con la clave gratuita?

Sí, las mismas reglas de plan valen para cada endpoint de esta página. Las 100 llamadas al día de la clave gratuita son el tope a vigilar cuando sondeas fixtures con especiales activados.

¿Qué deportes traen especiales?

Los ejemplos de la documentación son de fútbol, y la cobertura sigue lo que el tablero cotiza. Llama al endpoint de fixtures con la bandera activada y cuenta los valores de special_category para ver la oferta actual antes de prometer un mercado.

¿Los props aparecen en las alertas de caída?

La documentación presenta los especiales en los endpoints de fixtures y markets prepartido; los streams de caídas siguen los mercados principales. Sondea los especiales que te importan en vez de esperar una alerta.

¿Cómo uno un prop a su partido?

Lee el parent_id en la fila del especial; es el event_id del partido principal. Con include_specials=nested las filas ya llegan agrupadas bajo el padre.

pinnacle odds api / player props / specials

Player props y mercados especiales en la API de cuotas de Pinnacle

GET/kit/v1/prematch/fixtures?include_specials=1

{ events: [.. especiales ..] }200 OK

Más allá de los mercados principales del partido, el feed trae los mercados especiales de Pinnacle: player props como goleador en cualquier momento, props de equipo como margen de victoria o par e impar, marcador exacto y futuros de torneo. Vienen excluidos por defecto para que las integraciones existentes mantengan el tamaño del payload; pasa include_specials=1 en la llamada de fixtures o markets para recibirlos. La clave gratuita cubre cada solicitud de esta página: 20 por minuto y 100 al día, cifras verificadas el 28/10/2026.

Crear una clave gratuita

Cada especial es su propia fila de evento

Un prop no se esconde dentro del objeto del partido: cada especial llega como su propia fila con su propio event_id, unido al partido principal por parent_id. Tres campos extra lo describen: special nombra el mercado ("Anytime Goalscorer", "Winning Margin"), special_category lo agrupa ("Player Props", "Team Props", "Exact Scores", "Futures"), y special_units dice en qué unidad cuentan los resultados, como córners o carreras.

La bandera tiene dos formas: include_specials=1 devuelve filas planas, el par más barato con un cursor since, e include_specials=nested agrupa los especiales bajo el array del propio evento padre cuando quieres una fila por partido.

props.sh

# Player props in one soccer
# fixture list. The key and
# base URL come from your
# account and the docs.
export ODDS_API_KEY="your key"
export ODDS_BASE_URL="https://..."

U="$ODDS_BASE_URL/kit/v1/prematch/fixtures"
H="x-portal-apikey: $ODDS_API_KEY"

# Specials are off by default.
# Opt in flat (cheapest with a
# since cursor) or nested.
curl -s -H "$H" \
  "$U?sport_id=1&include_specials=1" \
  | jq -r '.events[]
    | select(.special_category)
    | [.parent_id, .special_category,
       .special] | @tsv' | head

GET/kit/v1/prematch/markets?event_id=..

resultados nombrados por período200 OK

Lee los precios de un especial

Conocido el event_id de un especial, pásalo al endpoint de mercados prepartido; allí ninguna bandera hace falta. Sus precios viven en special_markets, por período: cada entrada trae un array prices donde name es la etiqueta del resultado (un jugador, "Yes", "2-1", "4+"), price es la cuota decimal y max_risk es la apuesta máxima del book para ese mercado.

Trata los especiales como más lentos que el tablero: las alertas de caída y el stream de caídas prepartido siguen los mercados principales, así que un poller con cursor since en la llamada de fixtures es la forma honesta de vigilar precios de props, a la cadencia que tu plan permite. La página de Python muestra el bucle de cursor que lleva este script a un job programado.

Lo que la gente pregunta sobre los especiales

Respuestas cortas antes de construir sobre mercados de props.

¿Los props están disponibles con la clave gratuita?: Sí, las mismas reglas de plan valen para cada endpoint de esta página. Las 100 llamadas al día de la clave gratuita son el tope a vigilar cuando sondeas fixtures con especiales activados.
¿Qué deportes traen especiales?: Los ejemplos de la documentación son de fútbol, y la cobertura sigue lo que el tablero cotiza. Llama al endpoint de fixtures con la bandera activada y cuenta los valores de special_category para ver la oferta actual antes de prometer un mercado.
¿Los props aparecen en las alertas de caída?: La documentación presenta los especiales en los endpoints de fixtures y markets prepartido; los streams de caídas siguen los mercados principales. Sondea los especiales que te importan en vez de esperar una alerta.
¿Cómo uno un prop a su partido?: Lee el parent_id en la fila del especial; es el event_id del partido principal. Con include_specials=nested las filas ya llegan agrupadas bajo el padre.

SIGUIENTEbash props.sh

Una bandera, un segundo universo de mercados

La clave gratuita ejecuta todo lo de esta página. Cuando un tablero de props necesite más de 100 llamadas al día, la página de precios muestra el plan que sube el tope.

Crear una clave gratuita Lee la documentación de la API