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 Significa
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.
timestamp reflete quão recente é a entrega do dado pelo pipeline, não quando a linha se moveu pela última vez. Um timestamp atualizado significa que a linha está sendo entregada ativamente — ele não indica por si só quando a mesa de operações reprecificou o preço pela última vez.
Sem Campo Separado de “Última Mudança de Preço”
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 Diferente
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:
| Esporte | Taxa de “novos dados” da CDN da Pinnacle |
|---|---|
| Futebol | ~94% |
| Tênis | ~66% |
| NHL | ~51% |
| MLB | ~18% |
| NBA | ~9% |
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 Campo
{
"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. Enquanto esse valor continuar avançando a cada ciclo, a linha está sendo entregada ativamente. Isso não indica por si só que o preço foi re-observado da fonte neste ciclo — a mesa de operações da Pinnacle pode não ter reprecificado o total de bases do Sosa há horas, e esse é o comportamento esperado.
timestamp é um carimbo de entrega, não de idade do preço — não o use como seu único critério de frescor. Se ele parar de avançar em um mercado de liga principal, esse é um sinal do feed que vale a pena investigar. Se ele continuar avançando, a linha está sendo entregada ativamente; isso não indica por si só que o preço foi re-observado da fonte neste ciclo.
Por Que a Pinnacle É a Referência Sharp
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.
Relacionados
- Snapshot de Odds — o campo
timestampna resposta REST de odds - Streaming —
timestampem deltasodds: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