API de odds esportivas em tempo real com as cotações da Pinnacle

A PinnWire entrega as odds que a Pinnacle publica agora — futebol ao vivo e pré-jogo, incluindo Brasileirão — em JSON com odds decimais por REST, alertas de queda por SSE e um stream WebSocket opcional. Sem cadastro para testar: use key=demo.

Esta é a versão em português da API de odds da PinnWire. A documentação técnica completa está em inglês em /docs.

Teste a cobertura você mesmo

curl "https://pinnwire.com/kit/v1/prematch/fixtures?sport_id=1&key=demo"  # futebol pré-jogo
curl "https://pinnwire.com/kit/v1/markets?sport_id=1&key=demo"            # futebol ao vivo agora
curl "https://pinnwire.com/api/drops?limit=10&key=demo"                   # quedas de preço recentes

Cada resposta traz o campo generated_at em ISO-8601, e /v1/health traz last_odds_update_seconds_ago — dá para provar que o dado é atual em vez de acreditar na nossa palavra.

API de odds de futebol: o que aparece na prática

Em uma consulta feita em 2026-09-09, sport_id 1 devolveu 1.087 partidas de futebol pré-jogo, das quais 34 eram brasileiras, distribuídas em 8 competições: Série A, Série B, Gaúcho 2, Goiano 2, Carioca U20, Copa Santa Catarina, Copa U20 e Paranaense. Cada partida vinha com money_line (casa/empate/fora), handicaps asiáticos e totais, todos em odds decimais, com o limite máximo de aposta por linha no campo max.

Esses números são um retrato daquele dia, não uma garantia: a cobertura acompanha o calendário e o que a Pinnacle decide publicar. Rode o curl acima e veja o que existe hoje.

API de odds grátis para começar

Duas formas de testar sem cartão:

Os planos pagos começam em US$ 89/mês, com pagamento em cartão ou em cripto (BTC, ETH, USDC). Preços atuais em /#pricing.

Pinnacle e apostas esportivas: por que essa linha

A Pinnacle trabalha com margem baixa e limites altos, e aceita apostadores vencedores em vez de limitá-los. Por isso o preço dela costuma ser usado como referência de valor justo: quem monta modelo, bot de arbitragem ou cálculo de EV compara as outras casas contra a linha da Pinnacle. É essa linha que esta API entrega — com o preço sem margem disponível no campo nvp dos alertas de queda.

Leitura relacionada, em inglês: no-vig fair odds e dropping odds.

Limites honestos

Cobertura e números verificados em 2026-09-09 contra o feed em produção — confira sempre com a chave demo antes de comprar. Correções: [email protected]

Perguntas frequentes

Existe uma API de odds da Pinnacle para o futebol brasileiro?

Sim. A PinnWire entrega as cotações que a Pinnacle publica no momento, incluindo Brasileirão Série A, Série B e campeonatos estaduais quando estão no calendário. Consulte sport_id 1 com a chave demo e veja a cobertura real do dia antes de pagar qualquer coisa.

Tem uma API de odds grátis para testar?

Tem duas opções sem cartão. A chave pública key=demo funciona na hora, sem cadastro, com 10 requisições por minuto e 50 por dia, compartilhadas entre todos os visitantes. A chave de teste gratuita, enviada por e-mail, dá 100 requisições por dia de forma permanente e é sua.

As odds vêm em formato decimal ou americano?

As respostas REST entregam odds decimais em JSON, o formato usado no Brasil. O stream WebSocket bruto entrega os quadros originais da linha, em odds americanas, para quem quer converter por conta própria.

Qual a diferença entre REST, SSE e WebSocket aqui?

REST devolve o retrato atual do mercado quando você pergunta. SSE empurra alertas de queda de preço assim que uma queda de 1% ou mais é detectada. O WebSocket, um adicional opcional, empurra cada alteração de preço ao vivo e pré-jogo conforme ela acontece.

A PinnWire é uma casa de apostas?

Não. A PinnWire vende apenas dados de odds por API e não aceita apostas. Não temos vínculo com a Pinnacle nem com qualquer operador, e os dados cobrem exclusivamente a Pinnacle — não é um comparador de várias casas.