Delta de Cuotas

Obtén solo las cuotas que han cambiado desde una marca de tiempo dada. Este endpoint devuelve el mismo formato de cuotas que /odds pero filtrado a los elementos actualizados después de tu valor since, lo que lo hace ideal para clientes de polling que desean actualizaciones incrementales sin volver a obtener la instantánea completa.

GET /api/v1/odds/delta

AutenticaciónPermalink for this section

Requiere API key. Disponible para todos los planes.

Parámetros de ConsultaPermalink for this section

Ejemplos de SolicitudesPermalink for this section

# Obtener todos los cambios de cuotas en los últimos 30 segundos
curl -X GET "https://api.sharpapi.io/api/v1/odds/delta?since=2026-02-11T12:00:00Z&league=nba" \
  -H "X-API-Key: YOUR_API_KEY"

let since = new Date(Date.now() - 30000).toISOString();
 
async function pollDelta() {
  let offset = 0;
  while (true) {
    const response = await fetch(
      `https://api.sharpapi.io/api/v1/odds/delta?since=${since}&league=nba&limit=500&offset=${offset}`,
      { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
    );
    const { data, removed, pagination, meta, overflow } = await response.json();
 
    console.log(`${pagination.count} odds changed, ${removed.length} removed`);
 
    if (!pagination.has_more) {
      if (overflow) {
        // Página terminal, pero el escaneo acotado del servidor (nivel Free) no cubrió toda la ventana: las filas que quedaron fuera son inalcanzables con cualquier offset y esta marca de agua las saltaría. Rearranca en lugar de avanzar — ver «Cuando una ventana no se puede drenar».
        throw new Error(
          'delta window not fully scanned: re-baseline from /odds (cursor=), ' +
          "then resume with the FIRST baseline page's updated_at as since"
        );
      }
      // Página terminal: server_time es la marca de agua real — úsala como próximo since.
      since = meta.server_time;
      break;
    }
    if (pagination.next_offset === null) {
      // Ventana demasiado grande para paginar por offset — un since nuevo debe venir de una base /odds nueva, nunca de esta respuesta. Ver Patrón de Polling.
      throw new Error(
        'delta window exceeds offset paging: re-baseline from /odds (cursor=), ' +
        "then resume with the FIRST baseline page's updated_at as since"
      );
    }
    // since no cambia mientras se drena la ventana.
    offset = pagination.next_offset;
  }
}
 
// Poll every 5 seconds
setInterval(pollDelta, 5000);

import requests
import time
from datetime import datetime, timezone, timedelta
 
since = (datetime.now(timezone.utc) - timedelta(seconds=30)).isoformat()
 
while True:
    offset = 0
    while True:
        response = requests.get(
            'https://api.sharpapi.io/api/v1/odds/delta',
            params={'since': since, 'league': 'nba', 'limit': 500, 'offset': offset},
            headers={'X-API-Key': 'YOUR_API_KEY'}
        )
        result = response.json()
        pagination = result['pagination']
 
        print(f"{pagination['count']} odds changed, {len(result['removed'])} removed")
 
        if not pagination['has_more']:
            if result.get('overflow'):
                # Página terminal, pero el escaneo acotado del servidor (nivel Free) no cubrió toda la ventana: las filas que quedaron fuera son inalcanzables con cualquier offset y esta marca de agua las saltaría. Rearranca en lugar de avanzar — ver «Cuando una ventana no se puede drenar».
                raise RuntimeError(
                    'delta window not fully scanned: re-baseline from /odds '
                    "(cursor=), then resume with the FIRST baseline page's "
                    'updated_at as since'
                )
            # Página terminal: server_time es la marca de agua real — úsala como próximo since.
            since = result['meta']['server_time']
            break
        if pagination['next_offset'] is None:
            # Ventana demasiado grande para paginar por offset — un since nuevo debe venir de una base /odds nueva, nunca de esta respuesta. Ver Patrón de Polling.
            raise RuntimeError(
                'delta window exceeds offset paging: re-baseline from /odds '
                "(cursor=), then resume with the FIRST baseline page's "
                'updated_at as since'
            )
        # since no cambia mientras se drena la ventana.
        offset = pagination['next_offset']
 
    time.sleep(5)

RespuestaPermalink for this section

Éxito (200)Permalink for this section

{
  "data": [
    {
      "id": "199954867251468",
      "sportsbook": "draftkings",
      "event_id": "nba_celtics_lakers_2026-02-08_b3",
      "sport": "basketball",
      "league": "nba",
      "home_team": "Los Angeles Lakers",
      "away_team": "Boston Celtics",
      "market_type": "moneyline",
      "selection": "Boston Celtics",
      "selection_type": "away",
      "odds_american": -150,
      "odds_decimal": 1.667,
      "odds_probability": 0.60,
      "line": null,
      "event_start_time": "2026-02-08T19:00:00Z",
      "timestamp": "2026-02-08T12:00:15.125Z",
      "is_live": false,
      "is_main_line": true
    }
  ],
  "removed": [
    {
      "id": "102044417046441",
      "sportsbook": "pinnacle",
      "removed_at": "2026-02-08T12:00:07Z",
      "event_start": "2026-02-08T12:00:00Z",
      "was_live": false,
      "boundary": true
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 1,
    "has_more": false,
    "next_offset": null
  },
  "updated_at": "2026-02-08T12:00:20Z",
  "meta": {
    "server_time": "2026-02-08T12:00:20Z"
  }
}

Cabeceras de RespuestaPermalink for this section

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1737853200
X-Data-Delay: 0
X-Request-Id: req_delta_abc123

Respuestas de ErrorPermalink for this section

400 Falta el parámetro since

{
  "error": {
    "code": "validation_error",
    "message": "The 'since' parameter is required for the delta endpoint",
    "docs": "https://docs.sharpapi.io/en/api-reference/odds-delta"
  }
}

400 Offset demasiado grande

{
  "error": {
    "code": "offset_too_large",
    "message": "offset must be <= 500; page with `next_offset` until `has_more` is false, then advance `since` to the response's top-level `updated_at` (mirrored as `meta.server_time`; a response field, not a row field) — it holds at your current `since` while `has_more` is true; keep paging while `next_offset` is non-null even if `overflow` is true (that only means `total` is capped); when `next_offset` is null while `has_more` or `overflow` is true, re-bootstrap from paged `/odds` (`cursor=`) and resume delta with a fresh `since`",
    "max_offset": 500
  }
}

401 No autorizado

Si no se envía ninguna clave se devuelve missing_api_key; una clave inválida devuelve invalid_api_key.

{
  "error": {
    "code": "missing_api_key",
    "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

Esquema de Respuesta del DeltaPermalink for this section

El array data contiene los mismos objetos de cuotas que el endpoint /odds. Solo se incluyen las cuotas actualizadas después de la marca de tiempo since.

El Array removedPermalink for this section

El array removed de nivel superior nombra cada fila de cuotas que salió del tablero desde tu marca de tiempo since — mercados que una casa retiró (suspensión, un umbral de hándicap/total retirado por un movimiento de línea, evento liquidado). Borra estos ids de tu estado local; esta es la señal de cierre explícita, así que nunca necesitas comparar snapshots tú mismo. Presente solo cuando al menos una eliminación coincidió con tus filtros. Consulta Ciclo de Vida del Mercado para el mapa completo de señales de cierre/suspensión.

La respuesta de delta incluye campos adicionales:

Indicadores de Truncado y AcotaciónPermalink for this section

Aparecen dos indicadores booleanos opcionales de nivel superior solo cuando el servidor ha tenido que aplicar un límite de seguridad a la respuesta. Los clientes que se comportan correctamente y hacen polling a la cadencia recomendada nunca los ven.

Patrón de PollingPermalink for this section

El patrón de polling recomendado drena cada ventana y luego encadena since desde la página terminal:

1. Realiza una solicitud inicial con since establecido a una marca de tiempo reciente
2. Aplica data como upserts y removed como eliminaciones
3. Mientras pagination.has_more sea true y pagination.next_offset no sea null, solicita la página siguiente con offset igual a next_offset, manteniendo since sin cambios
4. En la página terminal (has_more: false), lee meta.server_time y úsalo como valor since en tu siguiente solicitud — salvo que overflow siga siendo true en esa página (escaneo acotado del nivel Free): entonces rearranca en lugar de avanzar (ver abajo)
5. Repite en el intervalo deseado (p. ej., cada 5 segundos)

Esto garantiza:

• Sin huecos - server_time es el reloj del servidor y solo avanza cuando ya tienes todas las filas de la ventana, así que no perderás actualizaciones por desfases de reloj ni por una lectura parcial
• Sin duplicados - cada ventana de delta no se solapa con las demás
• Carga útil mínima - solo se devuelven las cuotas que han cambiado

Cuando una ventana no se puede drenarPermalink for this section

offset está limitado a 500, así que una ventana con más cambios coincidentes de los que la paginación por offset puede alcanzar termina con next_offset: null mientras has_more sigue siendo true. En el nivel Free, el escaneo acotado del servidor puede además dejar overflow: true en la propia página terminal (has_more: false) — las filas más allá del presupuesto de escaneo son inalcanzables con cualquier offset, y avanzar since ahí las saltaría. Ambos estados son la misma señal — rearranca siempre que next_offset sea null mientras has_more u overflow sea true:

1. Obtén una base completa desde /odds con paginación cursor=
2. Reanuda el polling de delta con since establecido al updated_at de la primera página de la base — las páginas posteriores se leen más tarde; usar el valor de la última página dejaría huecos con los cambios que llegaron a páginas anteriores durante el rastreo

Haciendo polling a la cadencia recomendada con limit=500, las ventanas se mantienen lo bastante pequeñas como para que esta ruta rara vez sea necesaria.

Endpoints RelacionadosPermalink for this section

• Instantánea de Cuotas - Obtén la instantánea completa actual de cuotas
• SSE Stream - Actualizaciones push en tiempo real mediante Server-Sent Events
• WebSocket Stream - Actualizaciones push en tiempo real mediante WebSocket