pinnacle odds api / player props / specials
Player props e mercados especiais na API de odds da Pinnacle
GET/kit/v1/prematch/fixtures?include_specials=1
{ events: [.. especiais ..] }200 OK
Além dos mercados principais da partida, o feed carrega os mercados especiais da Pinnacle: player props como artilheiro a qualquer momento, props de equipe como margem de vitória ou par e ímpar, placar exato e futuros de torneio. Eles vêm excluídos por padrão para que integrações existentes mantenham o tamanho do payload; passe include_specials=1 na chamada de fixtures ou markets para recebê-los. A chave gratuita cobre cada requisição desta página: 20 por minuto e 100 por dia, valores verificados em 28/10/2026.
Cada especial é sua própria linha de evento
Um prop não se esconde dentro do objeto da partida: cada especial chega como sua própria linha com seu próprio event_id, ligado à partida principal pelo parent_id. Três campos extras o descrevem: special nomeia o mercado ("Anytime Goalscorer", "Winning Margin"), special_category o agrupa ("Player Props", "Team Props", "Exact Scores", "Futures"), e special_units diz em que unidade os resultados contam, como escanteios ou runs.
A flag tem duas formas: include_specials=1 retorna linhas planas, o par mais barato com um cursor since, e include_specials=nested agrupa os especiais sob o array do próprio evento pai quando você quer uma linha por partida.
# Player props in one soccer
# fixture list. The key and
# base URL come from your
# account and the docs.
export ODDS_API_KEY="your key"
export ODDS_BASE_URL="https://..."
U="$ODDS_BASE_URL/kit/v1/prematch/fixtures"
H="x-portal-apikey: $ODDS_API_KEY"
# Specials are off by default.
# Opt in flat (cheapest with a
# since cursor) or nested.
curl -s -H "$H" \
"$U?sport_id=1&include_specials=1" \
| jq -r '.events[]
| select(.special_category)
| [.parent_id, .special_category,
.special] | @tsv' | headSelecione o código para copiá-lo.
GET/kit/v1/prematch/markets?event_id=..
resultados nomeados por período200 OK
Leia os preços de um especial
Conhecido o event_id de um especial, passe-o ao endpoint de mercados pré-jogo; lá nenhuma flag é necessária. Seus preços ficam em special_markets, por período: cada entrada traz um array prices onde name é o rótulo do resultado (um jogador, "Yes", "2-1", "4+"), price é a odd decimal e max_risk é a aposta máxima do book para aquele mercado.
Trate os especiais como mais lentos que o quadro: os alertas de queda e o stream de quedas pré-jogo acompanham os mercados principais, então um poller com cursor since na chamada de fixtures é o jeito honesto de observar preços de props, na cadência que seu plano permite. A página de Python mostra o loop de cursor que leva este script a um job agendado.
O que as pessoas perguntam sobre especiais
Respostas curtas antes de construir sobre mercados de props.
- Props estão disponíveis na chave gratuita?
Sim, as mesmas regras de plano valem para cada endpoint desta página. As 100 chamadas por dia da chave gratuita são o teto a observar quando você faz polling de fixtures com especiais ligados.
- Quais esportes têm especiais?
Os exemplos da documentação são de futebol, e a cobertura segue o que o quadro precifica. Chame o endpoint de fixtures com a flag ligada e conte os valores de
special_categorypara ver a oferta atual antes de prometer um mercado.- Props aparecem nos alertas de queda?
A documentação apresenta os especiais nos endpoints de fixtures e markets pré-jogo; os streams de queda acompanham os mercados principais. Faça polling nos especiais que importam em vez de esperar um alerta.
- Como ligo um prop à sua partida?
Leia o
parent_idna linha do especial; é oevent_idda partida principal. Cominclude_specials=nestedas linhas já chegam agrupadas sob o pai.
PRÓXIMObash props.sh
Uma flag, um segundo universo de mercados
A chave gratuita roda tudo desta página. Quando um quadro de props precisar de mais de 100 chamadas por dia, a página de preços mostra o plano que sobe o teto.