Odds Delta

Get only the odds that have changed since a given timestamp. This endpoint returns the same odds format as /odds but filtered to items updated after your since value, making it ideal for polling clients that want incremental updates without re-fetching the full snapshot.

GET /api/v1/odds/delta

AuthenticationPermalink for this section

Requires API key. Available to all tiers.

Query ParametersPermalink for this section

Example RequestsPermalink for this section

# Get all odds changes in the last 30 seconds
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, removed, pagination, meta } = await response.json();
 
  console.log(`${pagination.count} odds changed, ${removed.length} removed`);
 
  // Chain on meta.server_time so windows never gap or overlap
  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"{result['pagination']['count']} odds changed, {len(result['removed'])} removed")
 
    # Chain on meta.server_time so windows never gap or overlap
    since = result['meta']['server_time']
    time.sleep(5)

ResponsePermalink for this section

Success (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" }
  ],
  "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"
  }
}

Response HeadersPermalink for this section

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

Error ResponsesPermalink for this section

400 Missing since parameter

{
  "error": {
    "code": "validation_error",
    "message": "since query parameter is required (ISO 8601 timestamp)"
  }
}

400 Offset too large

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

No key supplied returns missing_api_key; a bad key returns 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://sharpapi.io/docs/authentication"
  }
}

Delta Response SchemaPermalink for this section

The data array contains the same odds objects as the /odds endpoint. Only odds updated after the since timestamp are included.

The removed ArrayPermalink for this section

The top-level removed array names every odds row that left the board since your since timestamp — markets a book took down (suspension, a handicap/total threshold retired by a line move, event settled). Delete these ids from your local state; this is the explicit close signal, so you never need to diff snapshots yourself. Present only when at least one removal matched your filters. See Market Lifecycle for the full close/suspend signal map.

On top of the standard {data, pagination, updated_at} shape, the delta envelope adds:

Truncation and Clamping FlagsPermalink for this section

Two optional top-level boolean flags appear only when the server had to apply a safety limit to the response. Well-behaved clients polling at the recommended cadence never see them.

Polling PatternPermalink for this section

The recommended polling pattern uses server_time to chain requests:

1. Make an initial request with since set to a recent timestamp
2. Read meta.server_time from the response
3. Use that server_time as the since value in your next request
4. Repeat on your desired interval (e.g., every 5 seconds)

This ensures:

• No gaps - server_time is the server’s clock, so you won’t miss updates due to clock drift
• No duplicates - each delta window is non-overlapping
• Minimal payload - only changed odds are returned

Related EndpointsPermalink for this section

• Odds Snapshot - Get the full current odds snapshot
• SSE Stream - Real-time push updates via Server-Sent Events
• WebSocket Stream - Real-time push updates via WebSocket