Skip to Content
Conceitos PrincipaisO campo `timestamp`

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 em best_book), não o horário mais recente entre todos os books. Em /odds/comparison cada book carrega o seu.
  • Os streams e /odds/delta reenviam 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 move price_updated_at em /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:

EsporteTaxa 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

Last updated on