Entendendo o campo timestamp
Cada linha de odds que a SharpAPI entrega carrega o 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?”, que é price_updated_at. 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 SignificaLink permanente para esta seção
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.
price_updated_at: Quando o Preço MudouLink permanente para esta seção
As linhas de odds também carregam price_updated_at: o horário ISO 8601 em que o preço da linha foi atualizado pela última vez, no mesmo formato de timestamp. Ele está em /odds, /odds/batch, /odds/delta, /events/{id}/odds, /odds/best, /odds/comparison e nas linhas de odds dos streams SSE e WebSocket.
- Ele se move quando mudam o preço, a linha, o status ao vivo ou a suspensão, e quando mudam o livro de ordens ou o tamanho disponível (melhor bid ou ask,
best_bid_liquidity,total_liquidity,max_bet). Ele não se move quando a SharpAPI relê uma linha sem mudanças, então um preço congelado há horas mostra horas de idade. - Para a maioria dos books, é o horário em que a SharpAPI viu o novo valor pela primeira vez. Para alguns books que enviam um horário de mudança próprio confiável, é o horário do book.
- Quando a SharpAPI começa a acompanhar uma linha, por exemplo após um reinício, o primeiro valor é quando a SharpAPI viu a linha pela primeira vez, não necessariamente quando o book moveu o preço pela última vez.
- Omitido quando a linha não tem horário de mudança.
- Em
/odds/besté o horário do preço do melhor book (o indicado embest_book), não o horário mais recente entre todos os books. Em/odds/comparisoncada book carrega o seu. - Os streams e
/odds/deltareenviam uma linha quando mudam o preço, a linha, o status ou outros campos dela. Uma mudança apenas no livro de ordens ou no tamanho disponível moveprice_updated_atem/odds, mas pode não ser enviada por si só; o novo horário chega com a próxima atualização dessa linha.
Em uma linha calma da Pinnacle, timestamp continua avançando enquanto price_updated_at pode ter horas de idade. Os dois estão corretos.
Os antigos campos odds_changed_at, last_seen_at e wire_received_at foram removidos na v3.0.0.
Por Que a Pinnacle Pode Parecer DiferenteLink permanente para esta seção
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 CampoLink permanente para esta seção
{
"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 SharpLink permanente para esta seção
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.
RelacionadosLink permanente para esta seção
- 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