Escolha sua rota de acesso
O acesso oficial da Pinnacle e uma assinatura de dados de odds de terceiros são arranjos diferentes. A página atual da API da Pinnacle oferece solicitações sob medida para casos de uso empresariais, individuais e acadêmicos, sujeitas a aprovação e elegibilidade. Se você exige uma relação contratual oficial ou operações específicas de conta, comece pela rota de solicitação da própria Pinnacle. Uma assinatura de terceiros não é uma conta na Pinnacle nem uma garantia de acesso oficial. Conferido em 26 de setembro de 2026.
Para uma integração de terceiros, leia primeiro os limites de cobertura e escolha um plano com base nos dados que você consome. Chaves, checkout e gerenciamento de plano ficam no mesmo painel de conta.
Quatro passos até uma primeira resposta verificável
- Confirme a oferta. Pergunte ao serviço sobre os esportes, mercados, transporte e uso pretendido de que você precisa, incluindo qualquer redistribuição. Guarde o plano e os termos que aceitar.
- Crie a conta pelo link de acesso. Siga os passos atuais de cadastro e verificação, e guarde o e-mail de confirmação e os termos do plano para seus registros.
- Mantenha a chave no seu servidor. Armazene-a na variável de ambiente
ODDS_API_KEY. Nunca a cole em um playground público, coloque em JavaScript do navegador ou faça commit em um repositório. Envie-a no header de requisição documentadox-portal-apikey. - Requisite um snapshot e valide o envelope. Um status de sucesso é só a primeira verificação. Exija a estrutura de objeto documentada e um array
events, depois distinga um resultado vazio de dados malformados.
Estes passos seguem a documentação atual, conferida em 26 de setembro de 2026.
Autenticação não é o mesmo que direito de uso
Uma chave válida ainda pode não ter o transporte solicitado. Snapshots REST, alertas SSE e WebSocket bruto têm requisitos de plano diferentes. Antes de tratar um erro de conexão como problema de parser, confirme a assinatura atual da conta, os complementos e a política de conexões simultâneas.
Pare em erros de autenticação ou permissão e inspecione a conta. Não tente de novo uma chave inválida em loop apertado. Em limites de taxa, respeite o Retry-After quando fornecido; quando a janela da cota esgotada for desconhecida, pare e investigue. Uma retentativa deve consumir um orçamento limitado de tempo e tentativas. Registre o status e o código de erro, nunca a chave ou o corpo completo de um erro do servidor.
Termos de teste e demonstração
O nível gratuito não expira: 20 requisições por minuto e 100 requisições por dia, sem cartão, e a chave de API também serve como login da conta. Para avaliar os streams, uma demonstração completa de três dias com SSE, WebSocket bruto e 10 requisições por segundo está disponível sob solicitação. Confirme os direitos atuais na conta antes de depender deles. Conferido em 26 de setembro de 2026.
Comece sem comprar acesso
A chave gratuita não custa nada e não expira. Use-a para confirmar seu runtime, parser e mensagens de erro contra respostas reais antes de gastar qualquer coisa. Ao migrar para um plano pago, trate a primeira resposta com o novo direito de uso como uma nova etapa de validação: o sucesso no nível gratuito não comprova acesso a streaming, latência ou os mercados exatos que você vai comprar.