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.

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 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 actualizó esta fila por última vez a las 21:35:02Z. Mientras ese valor siga avanzando en cada ciclo, la fila está siendo entregada activamente. Eso no indica por sí solo que el precio haya sido re-observado en este ciclo.

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 entregando la fila activamente. Eso no indica por sí solo que el precio haya sido re-observado en este ciclo — Pinnacle puede no haberlo movido en horas, y eso es comportamiento normal.

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