Cruze uma cota da API da Pinnacle e duas coisas não acontecem: você não é cobrado a mais, e a API não continua te servindo em silêncio. O que você recebe é uma resposta 429, uma instrução Retry-After quando a janela é curta, e uma decisão a tomar. Veja o que cada limite faz, e o que fazer quando um morde.
Os dois tipos de limite
Todo plano carrega um teto de taxa. O plano de snapshots REST roda a 10 requisições por segundo, o plano combinado nas mesmas 10 com alertas incluídos, e o plano de alto volume a 30 por segundo, como o guia de planos os lista, verificado em 2026-09-30. A chave gratuita e o lado REST do plano SSE carregam tetos de calendário: 20 requisições por minuto e 100 por dia na chave gratuita, com o plano SSE adicionando uma janela de 100 por hora sobre a mesma cota REST.
Os dois tipos falham de forma diferente. Um teto por segundo reinicia em segundos. Um teto diário reinicia amanhã.
O que cruzar a linha retorna
Cruze um teto de taxa e a API responde 429 Too Many Requests, normalmente com um cabeçalho Retry-After indicando os segundos a esperar. A regra da lista de acesso é respeitar o Retry-After quando fornecido, e quando a janela esgotada for desconhecida, parar e investigar em vez de tentar às cegas.
O teto diário é mais direto. Como a página da chave gratuita coloca, um poller que atinge o limite diário deve parar em vez de tentar de novo, porque um 429 do dia não se espera em segundos. Cada nova tentativa contra um teto diário é mais uma chamada desperdiçada contra uma janela que não vai abrir.
O que ele nunca faz
Os planos são pré-pagos com cotas fixas, e a página de preços não lista preço de excedente, verificado em 2026-09-30. Não há medidor rodando além do seu plano nem linha surpresa na fatura. O outro lado importa igualmente: como nenhum excedente é precificado, você não deve assumir que requisições além da cota serão servidas. O teto é o plano.
Um limite por segundo publicado também não é uma meta. A página de preços avisa que um limite publicado não concede permissão para rodar permanentemente naquele teto; recue quando instruído e revise os limites atuais da conta.
Quando o limite está te dizendo algo
Um 429 ocasional num pico de dia de partida é normal. Um teto diário esgotado antes do almoço, ou um gotejamento constante de 429s no pico, é o plano dizendo que o loop cresceu além dele. A medição vem primeiro: registre as requisições por segundo que seu poller realmente usa no pico, depois compare com o teto deixando folga para novas tentativas.
Se o pico fica abaixo de cerca de 7 por segundo, os planos de 10 por segundo o carregam. Além disso, o plano de alto volume a 30 por segundo é o próximo passo, a US$ 229 por mês conforme publicado. O guia de planos mapeia cada loop ao seu plano, e a chave gratuita continua sendo o lugar para provar o loop antes de pagar pelo teto maior.
Um 429 é o plano funcionando como desenhado, não uma falha. Responda com uma espera, uma parada ou um upgrade, nessa ordem.