Cruza una cuota de la API de Pinnacle y dos cosas no ocurren: no se te cobra de más, y la API no sigue sirviéndote en silencio. Lo que recibes es una respuesta 429, una instrucción Retry-After cuando la ventana es corta, y una decisión que tomar. Esto es lo que hace cada límite, y qué hacer cuando uno muerde.
Los dos tipos de límite
Todo plan lleva un techo de tasa. El plan de snapshots REST corre a 10 solicitudes por segundo, el plan combinado a las mismas 10 con alertas incluidas, y el plan de alto volumen a 30 por segundo, como los lista la guía de planes, verificado el 2026-09-30. La clave gratuita y el lado REST del plan SSE llevan topes de calendario: 20 solicitudes por minuto y 100 al día en la clave gratuita, con el plan SSE añadiendo una ventana de 100 por hora sobre la misma cuota REST.
Los dos tipos fallan de forma distinta. Un techo por segundo se reinicia en segundos. Un tope diario se reinicia mañana.
Lo que devuelve cruzar la línea
Cruza un techo de tasa y la API responde 429 Too Many Requests, normalmente con una cabecera Retry-After que indica los segundos a esperar. La regla de la lista de acceso es respetar Retry-After cuando se proporciona, y cuando la ventana agotada es desconocida, parar e investigar en lugar de reintentar a ciegas.
El tope diario es más rotundo. Como dice la página de la clave gratuita, un sondeador que llega al límite diario debe parar en lugar de reintentar, porque un 429 del día no se espera en segundos. Cada reintento lanzado contra un tope diario es una llamada más desperdiciada contra una ventana que no va a abrirse.
Lo que nunca hace
Los planes son prepagados con cuotas fijas, y la página de precios no lista precio de excedente, verificado el 2026-09-30. No hay medidor corriendo más allá de tu plan ni línea sorpresa en la factura. La otra cara importa igual: como ningún excedente está tarifado, no debes asumir que las solicitudes pasada la cuota se servirán. El techo es el plan.
Un límite por segundo publicado tampoco es una meta. La página de precios advierte que un límite publicado no concede permiso para correr permanentemente en ese techo; retrocede cuando se te indique y revisa los límites actuales de la cuenta.
Cuando el límite te está diciendo algo
Un 429 ocasional en un pico de día de partido es normal. Un tope diario agotado antes del mediodía, o un goteo constante de 429 en el pico, es el plan diciendo que el bucle lo superó. La medición va primero: registra las solicitudes por segundo que tu sondeador usa de verdad en el pico, y luego compara con el techo dejando margen para reintentos.
Si el pico queda por debajo de unas 7 por segundo, los planes de 10 por segundo lo soportan. Más allá, el plan de alto volumen a 30 por segundo es el siguiente paso, a 229 USD al mes según lo publicado. La guía de planes mapea cada bucle a su plan, y la clave gratuita sigue siendo el lugar para probar el bucle antes de pagar el techo mayor.
Un 429 es el plan funcionando como se diseñó, no un fallo. Respóndelo con una espera, una parada o una mejora, en ese orden.