Notas de quickstart
Dónde se esconden los player props en el feed de cuotas
Los especiales vienen apagados por defecto, así que no hay nada que encontrar en el objeto del partido. Una flag los activa, y un join los anexa al partido.
Tienes el tablero funcionando, las cuotas fluyendo, y entonces alguien pregunta dónde están los mercados de goleador. Siempre estuvieron ahí. Los mercados especiales viven en el mismo feed, apagados por defecto, y encenderlos está a un parámetro y un join de distancia.
Por qué tu respuesta no tiene props
Los especiales se excluyen por defecto para que las integraciones existentes mantengan su tamaño de payload, como afirma la guía de player props, verificado el 2026-10-30. Pasa include_specials=1 en la llamada de fixtures o markets y llegan. La clave gratuita cubre cada una de esas solicitudes, a 20 por minuto y 100 al día.
Ese defecto explica la confusión clásica: el objeto del partido no está escondiendo una sección de props. No hay ningún campo que encontrar. Los especiales simplemente no se envían hasta que los pides.
Cada prop es su propia fila
La forma que sorprende a todos: un prop no vive dentro del objeto del partido. Cada especial llega como su propia fila de evento con su propio event_id, unida al partido principal por parent_id. Tres campos extra la describen: special nombra el mercado, special_category lo agrupa bajo etiquetas como Player Props, Team Props, Exact Scores o Futures, y special_units dice qué cuentan los resultados, córners o carreras o lo que el mercado mida.
Así que el join es un group-by. Recoge las filas, agrupa los especiales bajo su parent_id, y tienes un partido con sus props anexados.
Plano o anidado es una elección de flujo
La flag tiene dos formas, según la misma guía. include_specials=1 devuelve filas planas, que combinan más barato con un cursor since: cada lectura delta lleva solo lo que cambió, prop o partido. include_specials=nested agrupa los especiales bajo el array del propio evento padre, lo que sirve a vistas de una fila por partido.
Plano primero, nested si la vista lo necesita. La forma plana es la que sigue siendo barata a medida que la jornada crece.
El campo de unidades no es decoración
Una cuota en "más de 2.5" no significa nada hasta que sabes qué se está contando. El campo special_units lo lleva, y dos mercados con líneas idénticas pueden contar cosas distintas. Lee las unidades antes que la cuota, siempre, sobre todo cuando una categoría como Exact Scores se mezcla con mercados de jugador en el mismo grupo.
Es el campo que mantiene un prop en la sección correcta de la pantalla y, luego, en el cubo correcto de liquidación.
Una comprobación de cinco minutos
Haz una llamada de fixtures de prepartido con la flag activada, filtra por el parent_id de un partido, y mira lo que llegó. Nombres, categorías, unidades, cuotas: todo lo que un tablero de props necesita está en las filas. El quickstart en la página de player props tiene la versión en curl y jq lista para ejecutar, verificado el 2026-10-30.
Los especiales nunca faltaron. Estaban esperando un parámetro.