Skip to Content
Conceptos básicosEl campo `timestamp`

Entendiendo el campo timestamp

Cada fila de cuotas que devuelve SharpAPI lleva el 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 qué indica price_updated_at: cuándo se movió el precio por última vez.

Qué significa realmente timestampEnlace permanente a esta sección

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.

timestamp no es la última vez que el precio se movió. Es cuándo SharpAPI refrescó por última vez la fila a través de su pipeline. La última vez que el precio se movió la indica price_updated_at, descrito más abajo.

price_updated_at: cuándo cambió el precioEnlace permanente a esta sección

Las filas de cuotas también llevan price_updated_at: la hora ISO 8601 en que se actualizó por última vez el precio de la fila, en el mismo formato que timestamp. Está en /odds, /odds/batch, /odds/delta, /events/{id}/odds, /odds/best, /odds/comparison y en las filas de cuotas de los streams SSE y WebSocket.

  • Se mueve cuando cambian el precio, la línea, el estado en vivo o la suspensión, y cuando cambian el libro de órdenes o el tamaño disponible (mejor bid o ask, best_bid_liquidity, total_liquidity, max_bet). No se mueve cuando SharpAPI vuelve a leer una fila sin cambios, así que un precio congelado durante horas indica horas de antigüedad.
  • Para la mayoría de las casas es la hora en que SharpAPI vio el nuevo valor por primera vez. Para unas pocas casas que envían una hora de cambio propia fiable, es la hora de la casa.
  • Cuando SharpAPI empieza a seguir una fila, por ejemplo tras un reinicio, el primer valor es cuándo SharpAPI vio la fila por primera vez, no necesariamente cuándo la casa movió el precio por última vez.
  • Se omite cuando la fila no tiene hora de cambio.
  • En /odds/best es la hora del precio de la mejor casa (la indicada en best_book), no la hora más reciente entre todas las casas. En /odds/comparison cada casa lleva la suya.
  • Los streams y /odds/delta reenvían una fila cuando cambian su precio, su línea, su estado u otros campos de la fila. Un cambio solo en el libro de órdenes o en el tamaño disponible mueve price_updated_at en /odds, pero puede no enviarse por sí solo; la nueva hora llega con la siguiente actualización de esa fila.

Los antiguos campos odds_changed_at, last_seen_at y wire_received_at se eliminaron en la v3.0.0.

Cómo usar timestamp para la frescuraEnlace permanente a esta sección

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

ObservaciónQué significa
timestamp reciente (segundos de antigüedad)El pipeline está entregando activamente esa fila — la fila está siendo mantenida. No indica por sí solo que el precio haya sido re-observado en este ciclo
timestamp obsoleto (más de uno o dos minutos en una liga importante)Señal del feed que merece investigarse — la casa puede haberse quedado en silencio o estar experimentando retrasos
{ "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 PinnacleEnlace permanente a esta sección

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. Mientras timestamp siga avanzando, el pipeline sigue entregando la fila activamente, y price_updated_at puede tener horas de antigüedad porque Pinnacle no ha movido el precio. Ambos son correctos.

RelacionadoEnlace permanente a esta sección

Last updated on