Entendiendo el campo timestamp

Cada fila de cuotas que devuelve SharpAPI lleva un único campo de marca temporal: timestamp. Los clientes sharp que desarrollan herramientas de +EV y arbitraje suelen preguntar qué representa exactamente y cómo usarlo para juzgar si una cuota está actualizada. La respuesta corta: timestamp es una señal de entrega / frescura del feed — indica cuándo SharpAPI refrescó por última vez esa fila a través de su pipeline, y avanza en cada ciclo de ingesta. Esta página explica qué registra realmente este campo y por qué SharpAPI ya no expone un campo separado para “cuándo se movió el precio por última vez”.

Qué significa realmente timestampPermalink for this section

timestamp es la hora ISO 8601 en que SharpAPI refrescó por última vez esa cuota a través de su pipeline. Avanza en cada ciclo de ingesta, independientemente de si el precio, la línea o el flag is_live cambiaron. Es una señal de frescura del feed y de actividad (liveness): mientras timestamp siga avanzando, sabes que el pipeline sigue observando esa casa y ese mercado.

Este comportamiento coincide con el campo timestamp de OpticOdds, de modo que si migras desde su feed o ejecutas ambos en paralelo, la semántica es la misma.

Por qué no hay un campo de “precio cambiado por última vez”Permalink for this section

En versiones anteriores, SharpAPI exponía campos separados (odds_changed_at, last_seen_at, wire_received_at) que intentaban distinguir la marca de la mesa de trading de la casa, la observación del adaptador y la llegada al pipeline. En la práctica, esos campos eran inconsistentes entre casas: muchas casas no publican una marca propia fiable de “precio cambiado”, por lo que el valor a menudo no significaba lo que los clientes esperaban.

A partir de la v3.0.0, SharpAPI se consolida en un único timestamp con semántica de entrega / frescura del feed —el mismo modelo que usa OpticOdds— para que el significado del campo sea idéntico en todas las casas. Si necesitas detectar cuándo se movió realmente un precio, compara los valores de cuota entre instantáneas sucesivas en tu propio cliente, en lugar de depender de una marca por fila.

Cómo usar timestamp para la frescuraPermalink for this section

Como timestamp avanza en cada ciclo de ingesta, es una lectura directa de la frescura del feed:

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

En este ejemplo, el pipeline refrescó esta fila pocos segundos antes de que el cliente la consultara (timestamp está actualizado), así que el precio mostrado está vigente.

Una nota sobre PinnaclePermalink for this section

Pinnacle es un creador de mercado: su mesa de trading publica un precio nuevo solo cuando el flujo real obliga a una revaloración, en lugar de sesgar las líneas en torno a la acción minorista. Esa disciplina es la razón por la que Pinnacle se utiliza como referencia sharp de devig para +EV: sus líneas son lo más cercano a un precio justo disponible en el mercado.

Una consecuencia práctica es que las líneas de Pinnacle pueden permanecer sin cambios durante largos periodos cuando nada en el mercado se ha movido —es habitual en props de jugadores de MLB y en mercados de la NBA—. Esto es normal. Con el modelo de timestamp, no hay que preocuparse de interpretar una marca de “precio cambiado” antigua: mientras timestamp siga avanzando, el pipeline sigue observando la fila y el precio mostrado está vigente, aunque Pinnacle no lo haya movido.

RelacionadoPermalink for this section

• Instantánea de cuotas — el campo timestamp en la respuesta REST de cuotas
• Streaming — timestamp en los deltas odds:update
• En vivo vs. Previo al partido — ritmo de publicación y mecanismos de entrega de los books
• Cálculo de EV — por qué Pinnacle es la referencia sharp