Skip to main content
Recargar todo el board en cada petición es un desperdicio. En su lugar, abre una sesión: un snapshot para establecer su base, y después deltas calculados respecto a ella.
  1. /api/snapshot devuelve el estado actual y le entrega un token. Aquí es donde declara su ámbito.
  2. /api/updated?since=<token> devuelve solo las líneas modificadas desde ese token, más un nuevo token para la llamada siguiente.
/api/updated nunca devuelve un snapshot: sin since responde 400. La separación es deliberada — un endpoint llamado updated que devolviera todo el libro sería desconcertante, y caro.
El campo window_seconds indica el tiempo cubierto por su delta — útil para ajustar su cadencia.

​
Definir el ámbito de su sesión

La llamada al snapshot es también donde dice de qué trata su sesión. Añada sport_id, league_id, event_id, market o period (se aceptan listas separadas por comas): el snapshot se limita a ese ámbito, y el token recibido lleva ese ámbito consigo. A partir de ahí solo envía el token. El servidor sabe sobre qué base calcular el delta, y su ámbito no puede desviarse a mitad de sesión por haber olvidado un parámetro.
Cada respuesta refleja el scope, para que siempre sepa qué significa su token. Para cambiar de ámbito, abra una nueva sesión con un nuevo snapshot.

​
Lo que cuesta

Una llamada cuesta 1 + el número de líneas devueltas. La frecuencia es casi gratuita; lo que se paga es el volumen. Dos consecuencias conviene anticipar. El ámbito es la principal palanca sobre su factura. Medido en el libro en directo, un ámbito moneyline / tiempo reglamentario representa alrededor del 5 % de los movimientos — es decir, cerca del 5 % del coste de seguirlo todo. Su snapshot se factura igual, y esa es la otra razón para acotarlo: un snapshot del libro entero supera las 20 000 líneas. Consultar más a menudo no le da datos más frescos gratis. Un precio que se mueve cinco veces en treinta segundos aparece una sola vez en un delta de 30 segundos, y hasta cinco veces con intervalos de 5 segundos, porque el cursor sigue el último cambio real de cada mercado. Una cadencia más rápida compra granularidad, no frescura.
Conserve el último token recibido y devuélvalo en cada llamada. Los tokens son opacos: trátelos como un cursor, no como una marca de tiempo que pueda calcular.
Si quiere un ámbito en continuo en lugar de a intervalos, el flujo WebSocket es mucho más barato: la conexión cuesta 1 petición, una sola vez, y acepta los mismos filtros como suscripción.