Entendendo o campo timestamp

Cada linha de odds que a SharpAPI entrega carrega um único campo de horário: timestamp. Ele responde a uma pergunta — “quão recente é este dado?” — e não a “quando o preço mudou pela última vez?”. Esta página explica o que o campo realmente registra, por que ele avança constantemente, e como interpretá-lo como um sinal de frescor do feed.

O Que timestamp Realmente SignificaPermalink for this section

timestamp é o horário ISO 8601 em que a SharpAPI atualizou esta odd pela última vez através do seu pipeline. Ele avança a cada ciclo de ingestão, independentemente de o preço ter se movido. Em outras palavras, é um sinal de entrega / frescor / liveness do feed — a mesma semântica do timestamp da OpticOdds.

Sem Campo Separado de “Última Mudança de Preço”Permalink for this section

A SharpAPI não expõe mais um campo separado para “quando o preço mudou pela última vez”. Versões anteriores carregavam campos como odds_changed_at, last_seen_at e wire_received_at; eles foram removidos em favor do único timestamp. Se o seu cliente dependia de qualquer um desses campos, leia timestamp em vez disso e trate-o como um sinal de frescor.

Isso simplifica o modelo: há um carimbo de horário por linha de odds, e ele significa “atualizado pela última vez através do nosso pipeline neste momento”.

Por Que a Pinnacle Pode Parecer DiferentePermalink for this section

A Pinnacle é uma formadora de mercado (market-maker). A mesa de operações deles publica um novo preço apenas quando o fluxo real força uma reprecificação — eles não distorcem linhas em torno da ação do varejo para extrair margem da forma como as casas soft fazem. Essa disciplina é a razão pela qual a Pinnacle é usada como referência sharp para cálculos de +EV.

Como a SharpAPI agora reporta timestamp como frescor do feed, uma linha da Pinnacle terá um timestamp atualizado sempre que a ingerimos novamente — mesmo que a mesa de operações deles não tenha movido a linha há 30+ minutos. O timestamp atualizado confirma que o dado está fresco; ele não implica que o preço mudou.

Observado durante uma janela de 24 horas das próprias respostas de CDN da Pinnacle, a taxa em que a Pinnacle publicou novos dados (em vez de um 304 Not Modified em cache) varia enormemente por esporte:

Player props de NBA e MLB comumente passam longas janelas sem que a mesa de operações da Pinnacle mova a linha. Isso é a cadência de publicação própria da Pinnacle, não uma falha no pipeline — e como timestamp é um sinal de frescor, ele permanece atualizado durante essas janelas, indicando que o preço exibido continua sendo o preço atual.

Como Ler o CampoPermalink for this section

{
  "sportsbook": "pinnacle",
  "market_type": "player_total_bases",
  "selection": "Edmundo Sosa Over",
  "line": 0.5,
  "odds_american": -129,
  "timestamp": "2026-04-21T21:35:02Z"
}

Neste exemplo, o timestamp mostra que a SharpAPI atualizou esta linha através do seu pipeline às 21:35:02 UTC. O dado é fresco. A mesa de operações da Pinnacle pode não ter reprecificado o total de bases do Sosa há horas, mas isso não é mais reportado em um campo separado — o timestamp atualizado confirma que o preço exibido é o preço atual.

Por Que a Pinnacle É a Referência SharpPermalink for this section

A Pinnacle aceita ação sharp e reprecifica com base no fluxo real, em vez de distorcer linhas em torno de apostadores de varejo. Essa disciplina de formadora de mercado é por que a usamos como referência de devig para +EV — as linhas deles são o mais próximo de um preço justo disponível no mercado. O trade-off é que as linhas pré-jogo podem permanecer no mesmo preço por longos períodos quando nada no mercado se moveu. Com timestamp como sinal de frescor, você sempre sabe que o dado é recente, mesmo quando o preço está estável.

RelacionadosPermalink for this section

• Snapshot de Odds — o campo timestamp na resposta REST de odds
• Streaming — timestamp em deltas odds:update
• Ao Vivo vs. Pré-Jogo — cadência de publicação e mecanismos de entrega das casas
• Cálculo de EV — por que a Pinnacle é a referência sharp