pnclFEED Clave gratuita

Notas de quickstart

Caídas sin el stream: sondeando el endpoint de drops

No hace falta un plan SSE para alertas de caída en horario: el endpoint REST de drops devuelve movimientos recientes como JSON puro, y un cron basta.

No todo el mundo necesita una conexión mantenida abierta. Si quieres ver las caídas de precio recientes en un horario en lugar de en tiempo real, el endpoint REST de drops las devuelve como JSON puro, y un cron job que lo llame cada pocos minutos es un montaje completo de alertas. Sin stream, sin plan con SSE, solo un sondeo.

Lo que el endpoint devuelve

El endpoint de drops te entrega los movimientos que el feed detectó en los últimos minutos, como lo describe el quickstart de curl, verificado el 2026-10-18. Eliges en vivo o prepartido con el parámetro mode, fijas el tamaño del movimiento con min_drop_pct, y acotas la edad con max_age_sec. Cada caída nombra el partido, el mercado y el lado, y lleva los precios de antes y después.

Una llamada devuelve una ventana acotada de historia, no un feed en vivo: estás leyendo lo que cayó recientemente, en tu horario.

El patrón de sondeo

El sondeo es un cron job o un temporizador que llama al endpoint e imprime lo que hay de nuevo:

curl -s -H "x-portal-apikey: $ODDS_API_KEY" \
  "$ODDS_BASE_URL/api/drops?mode=prematch&min_drop_pct=5&max_age_sec=300" \
  | jq '.drops[] | [.home, .away, .sect, .from_price, .to_price] | @tsv'

Mantén la ventana de edad algo más ancha que tu intervalo de sondeo, para que una ejecución lenta nunca se salte un movimiento en silencio, y guarda los ids de caída que ya has visto para que cada una reporte una vez.

El lado del presupuesto

Esta es la parte que importa para la clave gratuita: el endpoint de drops es una llamada REST, así que gasta de la misma cuota diaria de 100 llamadas que lista la página de precios, verificado el 2026-10-18. Un sondeo cada 15 minutos cabe en la clave gratuita todo el día con 96 llamadas, y te da un resumen por cuarto de hora de toda caída más allá de tu umbral.

Cada minuto en lugar de cada quince son 1.440 llamadas al día y pertenece a un plan de pago, que la página de precios lista por tasa.

A lo que renuncias

El stream empuja una caída en el momento en que se detecta; un sondeo la ve en la siguiente ronda. Para movimientos prepartido, donde la brecha en otras casas dura minutos o más, el retraso raramente importa. Para movimientos en vivo, sí, y esa es la línea honesta entre los dos: las caídas que expiran en segundos pertenecen al stream, y todo lo demás sondea bien.

Un endpoint, un temporizador, una lista de deduplicación. El endpoint de drops es el hermano paciente del stream, y para una vigilancia por cuarto de hora es todo lo que necesitas.