Nível gratuito · REST

A chave gratuita da API da Pinnacle: 100 requisições por dia, e o que elas compram.

A chave gratuita é uma chave de verdade nos mesmos endpoints REST dos planos pagos: 20 requisições por minuto, 100 por dia, sem cartão, sem validade. Ela serve para protótipos e atualizações lentas. Não serve para polling.

Atualizado em · Exemplos originais · testado apenas com mocks

O que a chave gratuita inclui

O nível gratuito é acesso REST aos mercados ao vivo e pré-jogo com a profundidade de linha completa, limitado a 20 requisições por minuto e 100 por dia. Não há cartão para informar nem data de validade; a chave também serve como login do painel da conta. Ela alcança a mesma rota /kit/v1/markets e o mesmo envelope de resposta dos planos REST pagos, então o código escrito contra ela passa para um plano pago sem mudanças. Conferido contra a documentação do provedor em 26 de setembro de 2026.

Duas coisas não estão nela. O stream SSE de quedas faz parte do plano de alertas e dos dois planos combinados, e o WebSocket bruto é um complemento dos três planos REST. Uma chave gratuita que abre o stream recebe uma mensagem de controle dizendo que o plano não o inclui, e não alertas. Para avaliar esses transportes, o provedor oferece uma demonstração completa de três dias sob pedido, com SSE, WebSocket bruto e 10 requisições por segundo.

O que 100 requisições por dia cobrem

Uma requisição devolve um quadro de esporte inteiro, cada evento com sua money line, spreads e totais em todos os períodos. A contagem que importa é quadros multiplicados por atualizações, não eventos.

UsoRequisições por diaCabe na chave gratuita
Uma planilha que atualiza um esporte a cada 15 minutos96Sim
Um esporte consultado a cada 5 minutos por 8 horas96Sim
Três esportes a cada 5 minutos por 8 horas288Não
Inspecionar respostas enquanto escreve um parserAlgumas dezenasSim
Preços ao vivo durante uma partida, a cada 10 segundos360 por horaNão

A primeira linha é o padrão em torno do qual o quickstart de Google Sheets no pnclFEED foi construído: uma chamada a cada 15 minutos, 96 por dia, dentro da cota. O teto de 20 por minuto raramente importa nesses ritmos; ele existe para impedir que uma rajada gaste o dia em cinco minutos.

Fazendo o orçamento render mais

O cursor since não reduz a contagem de requisições, só o payload: uma chamada de delta ainda é uma chamada. O que reduz a contagem é escopo e programação. Consulte um quadro em vez de cinco, consulte nas horas em que o esporte é jogado, e faça de um único processo o único chamador enquanto todo dashboard, planilha e modelo lê da cópia desse processo. Um cache na frente da chave transforma cinquenta leitores em uma requisição.

Verifique a contagem antes que ela acabe. Em 90 requisições, as 10 restantes devem ficar reservadas para as chamadas agendadas, e um poller que atinge o limite diário deve parar em vez de tentar de novo, porque um 429 do dia não pode ser esperado em segundos. A calculadora de custo da API no pnclAPI transforma intervalo, horas e quadros em um valor diário para qualquer programação.

Quando um plano pago compensa

No momento em que uma programação precisa de mais de um quadro a cada 15 minutos, a chave gratuita deixa de ser o plano. O plano de snapshots REST eleva o teto para 10 requisições por segundo por US$ 99 por mês, ou US$ 249 por três meses e US$ 449 por seis. Alertas sem polling são o plano SSE a US$ 99, alertas com polling são US$ 149, e o plano de alto volume a US$ 229 roda a 30 requisições por segundo com alertas incluídos. A página de preços lista todos os termos, e o guia de planos combina cada um com o loop que você está escrevendo.

Obtendo e guardando a chave

Crie a conta pelo link de acesso, copie a chave do painel e mantenha-a no servidor em uma variável de ambiente. Envie-a no header x-portal-apikey. Nunca a coloque em JavaScript de navegador nem em um repositório público; o checklist de acesso percorre a primeira requisição e como validar o envelope que ela devolve.

Perguntas sobre o nível gratuito

A chave gratuita expira ou precisa ser renovada?

Não. Os termos publicados não têm validade nem cartão. Ela continua válida até você fazer upgrade ou a conta ser encerrada.

Os preços são os mesmos dos planos pagos?

Sim. Os endpoints e o envelope são os mesmos; os planos diferem na taxa, no limite diário e nos transportes que incluem, não nos dados.

Posso testar o stream SSE de graça?

Não com a chave gratuita. Peça ao provedor a demonstração completa de três dias, que inclui o stream e o WebSocket bruto.

Cotas e preços seguem os termos publicados pelo provedor, conferidos em 26 de setembro de 2026. Publicado em 29 de setembro de 2026.

Seu próximo passo

Confira o encaixe. Depois obtenha acesso.

Confirme os mercados, o transporte e os termos de conta de que você precisa antes de escolher um plano.