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/bestes la hora del precio de la mejor casa (la indicada enbest_book), no la hora más reciente entre todas las casas. En/odds/comparisoncada casa lleva la suya. - Los streams y
/odds/deltareenví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 mueveprice_updated_aten/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ón | Qué 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
- Instantánea de cuotas — el campo
timestampen la respuesta REST de cuotas - Streaming —
timestampen los deltasodds: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