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ón

Requiere API key. Disponible para todos los planes.

Parámetros de Consulta

Ejemplos de Solicitudes

# 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() {
  const response = await fetch(
    `https://api.sharpapi.io/api/v1/odds/delta?since=${since}&league=nba`,
    { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
  );
  const { data, meta } = await response.json();
 
  console.log(`${data.length} odds changed, books updated: ${meta.books_changed.join(', ')}`);
 
  // Use server_time as the next since value
  since = meta.server_time;
}
 
// 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:
    response = requests.get(
        'https://api.sharpapi.io/api/v1/odds/delta',
        params={'since': since, 'league': 'nba'},
        headers={'X-API-Key': 'YOUR_API_KEY'}
    )
    result = response.json()
 
    print(f"{len(result['data'])} odds changed")
    print(f"Books updated: {result['meta']['books_changed']}")
 
    # Use server_time as the next since value
    since = result['meta']['server_time']
    time.sleep(5)

Respuesta

Éxito (200)

{
  "success": true,
  "data": [
    {
      "id": "draftkings_33483153_moneyline_PHO",
      "sportsbook": "draftkings",
      "event_id": "33483153",
      "sport": "basketball",
      "league": "nba",
      "home_team": "PHI 76ers",
      "away_team": "PHO Suns",
      "market_type": "moneyline",
      "selection": "PHO Suns",
      "selection_type": "away",
      "odds_american": -150,
      "odds_decimal": 1.667,
      "odds_probability": 0.60,
      "line": null,
      "event_start_time": "2026-02-11T19:00:00Z",
      "last_seen_at": "2026-02-11T12:00:15.125Z",
      "is_live": false,
      "status": "upcoming"
    }
  ],
  "meta": {
    "count": 1,
    "total": 1,
    "server_time": "2026-02-11T12:00:20.000Z",
    "books_changed": ["draftkings"],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "filters": {
      "since": "2026-02-11T12:00:00Z",
      "league": "nba"
    }
  }
}

Cabeceras de Respuesta

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

Respuestas de Error

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; advance `since` to the previous response's `updated_at` to retrieve older changes",
    "max_offset": 500
  }
}

401 No autorizado

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

Esquema de Respuesta del Delta

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 objeto meta incluye dos campos adicionales:

Indicadores de Truncado y Acotación

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 Polling

El patrón de polling recomendado utiliza server_time para encadenar solicitudes:

1. Realiza una solicitud inicial con since establecido a una marca de tiempo reciente
2. Lee meta.server_time de la respuesta
3. Usa ese server_time como valor since en tu siguiente solicitud
4. Repite en el intervalo deseado (p. ej., cada 5 segundos)

Esto garantiza:

• Sin huecos - server_time es el reloj del servidor, por lo que no perderás actualizaciones debido a desfases de reloj
• 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

Endpoints Relacionados

• 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