Quoten-Delta

Ruft nur die Quoten ab, die sich seit einem bestimmten Zeitstempel geändert haben. Dieser Endpoint gibt dasselbe Quotenformat wie /odds zurück, jedoch gefiltert auf Einträge, die nach Ihrem since-Wert aktualisiert wurden, was ihn ideal für Polling-Clients macht, die inkrementelle Aktualisierungen ohne erneutes Abrufen des vollständigen Snapshots wünschen.

GET /api/v1/odds/delta

Authentifizierung

Erfordert API key. Verfügbar für alle Tarife.

Query-Parameter

Beispielanfragen

# Alle Quotenänderungen der letzten 30 Sekunden abrufen
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)

Antwort

Erfolg (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"
    }
  }
}

Antwort-Header

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

Fehlerantworten

400 Fehlender since-Parameter

{
  "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 zu groß

{
  "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 Unauthorized

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

Delta-Antwort-Schema

Das data-Array enthält dieselben Quotenobjekte wie der /odds-Endpoint. Es werden nur Quoten einbezogen, die nach dem since-Zeitstempel aktualisiert wurden.

Das meta-Objekt enthält zwei zusätzliche Felder:

Truncation- und Clamping-Flags

Zwei optionale boolesche Flags auf oberster Ebene erscheinen nur, wenn der Server eine Sicherheitsbegrenzung auf die Antwort anwenden musste. Korrekt arbeitende Clients, die in der empfohlenen Frequenz pollen, sehen diese nie.

Polling-Muster

Das empfohlene Polling-Muster verwendet server_time, um Anfragen zu verketten:

1. Stellen Sie eine erste Anfrage mit since auf einen aktuellen Zeitstempel
2. Lesen Sie meta.server_time aus der Antwort
3. Verwenden Sie diesen server_time-Wert als since-Wert in Ihrer nächsten Anfrage
4. Wiederholen Sie dies in Ihrem gewünschten Intervall (z. B. alle 5 Sekunden)

Damit wird Folgendes sichergestellt:

• Keine Lücken – server_time ist die Serveruhr, sodass Sie aufgrund von Uhrenabweichungen keine Aktualisierungen verpassen
• Keine Duplikate – jedes Delta-Fenster überschneidet sich nicht
• Minimaler Payload – nur geänderte Quoten werden zurückgegeben

Verwandte Endpoints

• Quoten-Snapshot – Den vollständigen aktuellen Quoten-Snapshot abrufen
• SSE-Stream – Push-Aktualisierungen in Echtzeit über Server-Sent Events
• WebSocket-Stream – Push-Aktualisierungen in Echtzeit über WebSocket