Resposta · REST · Busca

Odds da Pinnacle de um time pelo nome

Atualizado em 9 de novembro de 2026 · PinnFeed · 2 min de leitura

Resposta: adicione q= em /v1/odds (ou /v1/events). É uma busca por substring, sem diferenciar maiúsculas, no mandante, no visitante e no nome da liga, então q=flamengo retorna todos os jogos do Flamengo no esporte informado, cada um com seus mercados. Em /v1/odds o parâmetro sport é obrigatório. Funciona em todos os planos, inclusive Free (30 s de atraso e só mercados principais).

curl#

curl -s "https://pinnfeed.io/v1/odds?sport=soccer&q=arsenal&market=moneyline&main=true" \
  -H "x-api-key: ps_live_your_key"

A resposta é {count, offset, limit, events: [...]}. Cada evento traz id, home, away, league {id, name, group}, startTime, live e um array markets com outcomes (decimal, american, fair, fairProb) mais margin e maxStake.

Python: só o próximo jogo#

import os, requests

KEY = os.environ["PINNFEED_KEY"]  # ps_live_...
r = requests.get(
    "https://pinnfeed.io/v1/odds",
    params={"sport": "soccer", "q": "arsenal", "market": "moneyline", "main": "true"},
    headers={"x-api-key": KEY},
    timeout=10,
)
r.raise_for_status()
events = r.json()["events"]          # sorted by start time, current events first
if events:
    ev = events[0]
    for m in ev["markets"]:
        prices = {o["name"]: o["decimal"] for o in m["outcomes"]}
        print(ev["home"], "v", ev["away"], ev["startTime"], prices, "maxStake", m["maxStake"])

Dicas#

Seja específico. q=united casa com vários clubes e com ligas que têm "United" no nome. Confira home/away no código ou use o id do evento: /v1/events/{id}.
Ligas também entram. q=serie retorna eventos cuja liga contém "Serie". Para um filtro estável use o id da liga (league=).
Os nomes vêm da Pinnacle. Não há mapeamento de times entre casas.
Push para um jogo. No Builder, assine o WebSocket com "events":[id] em vez de fazer polling.

Planos#

Free: 2 esportes, 1 req/s, 1.000 requisições por dia, 30 s de atraso. Builder (€99/mês) adiciona push em tempo real via WebSocket, os 13 esportes e todos os mercados. Teste de 3 dias; o cartão é obrigatório e a cobrança ocorre após o dia 3, a menos que você cancele. Chave grátis · docs.

Conteúdo educativo para maiores de 18 anos.

Perguntas frequentes#

A busca é aproximada?#

Não. É uma correspondência literal de substring sem diferenciar maiúsculas. "Fla" encontra "Flamengo", mas "Mengão" não.

Posso buscar em todos os esportes?#

/v1/events?q=... funciona sem esporte e busca em todos os esportes do seu plano (eventos, sem preços). /v1/odds precisa de sport.

Retorna jogos encerrados?#

Não. Só eventos que a Pinnacle lista agora. Para preços de fechamento no Builder: odds de fechamento.