Closing Line

Returns the closing-line snapshot for an event — the per-book odds captured the moment each sportsbook flipped the event from pre-match to live. The endpoint is the canonical source for closing-line value (CLV) analysis on bets placed before tip-off.


GET /api/v1/odds/closing

Each sportsbook is captured independently the first time it transitions a given event to is_live=true. Captured snapshots live in Valkey for 48 hours after the event starts. Beyond that window, use /api/v1/historical/odds/closing (Enterprise, ClickHouse-backed).

AuthenticationPermalink for this section

Requires API key. Available to Pro, Sharp, and Enterprise tiers (closing_line feature).

Query ParametersPermalink for this section

Parameter	Type	Default	Description
`event_id`	string	required	Event identifier. Same IDs as `/api/v1/events`.
`sportsbook`	string	all	Comma-separated book filter (e.g., `draftkings,fanduel`). `books=` is accepted as a legacy alias.

event_id is required. Omitting it returns 400 validation_error. Invalid characters in the value also return 400 validation_error.

Example RequestsPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/odds/closing?event_id=mlb_athletics_mariners_2026-04-22" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/odds/closing?event_id=mlb_athletics_mariners_2026-04-22',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
 
// Per-book closing prices for CLV
for (const [book, odds] of Object.entries(data.books)) {
  console.log(`${book}: ${odds.length} closing prices captured at ${data.captured_at}`);
}

Python


import requests
 
r = requests.get(
    "https://api.sharpapi.io/api/v1/odds/closing",
    params={"event_id": "mlb_athletics_mariners_2026-04-22"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
snap = r.json()["data"]
 
for book, odds in snap["books"].items():
    print(f"{book}: {len(odds)} closing prices")

ResponsePermalink for this section


{
  "success": true,
  "data": {
    "event_id": "mlb_athletics_mariners_2026-04-22",
    "sport": "baseball",
    "league": "mlb",
    "home_team": "Seattle Mariners",
    "away_team": "Athletics",
    "event_start_time": "2026-04-22T22:10:00Z",
    "captured_at": "2026-04-22T22:09:58.412Z",
    "books": {
      "draftkings": [
        {
          "sportsbook": "draftkings",
          "market_type": "moneyline",
          "selection": "Seattle Mariners",
          "selection_type": "home",
          "odds_american": -165,
          "odds_decimal": 1.606
        },
        {
          "sportsbook": "draftkings",
          "market_type": "spread",
          "selection": "Seattle Mariners",
          "selection_type": "home",
          "line": -1.5,
          "odds_american": 130,
          "odds_decimal": 2.30
        }
      ],
      "pinnacle": [
        {
          "sportsbook": "pinnacle",
          "market_type": "moneyline",
          "selection": "Seattle Mariners",
          "selection_type": "home",
          "odds_american": -158,
          "odds_decimal": 1.633
        }
      ]
    }
  },
  "meta": {
    "source": "valkey",
    "updated_at": "2026-04-22T17:34:54.692Z"
  }
}

Empty ResponsePermalink for this section

If no closing snapshot has been captured (event hasn’t started yet, or event ID has no captures within the 48h window), the response returns an empty books object:


{
  "success": true,
  "data": {
    "event_id": "mlb_athletics_mariners_2026-04-22",
    "books": {}
  },
  "meta": {
    "source": "valkey",
    "updated_at": "2026-04-22T17:34:54.692Z"
  }
}

Response FieldsPermalink for this section

Field	Type	Description
`data.event_id`	string	Event identifier echoed from the request.
`data.sport`	string	Sport (e.g., `baseball`). Empty when no captures exist.
`data.league`	string	League (e.g., `mlb`). Empty when no captures exist.
`data.home_team`, `data.away_team`	string	Team names. Empty when no captures exist.
`data.event_start_time`	string	ISO 8601 scheduled start time.
`data.captured_at`	string	ISO 8601 timestamp of the first capture (the earliest book to flip the event live).
`data.books`	object	Map of `book_id → ClosingOdd[]`. Empty `{}` if nothing captured.

`ClosingOdd` shapePermalink for this section

Field	Type	Description
`sportsbook`	string	Book identifier (lowercase).
`market_type`	string	e.g., `moneyline`, `spread`, `total`, `player_prop`.
`selection`	string	Selection label (e.g., team name, player name, `over`, `under`).
`selection_type`	string	`home`, `away`, `over`, `under`, etc.
`line`	number?	Spread or total line, when applicable. Omitted on moneylines.
`odds_american`	integer	American-format odds at the moment of capture.
`odds_decimal`	number	Decimal-format odds (3 decimal places).
`player_name`	string?	Present for player props.
`stat_category`	string?	Stat category (`points`, `rebounds`, etc.) for player props.

CachingPermalink for this section

Responses are cached at the edge for 30s (s-maxage=30) and at the client for 10s (max-age=10). Closing snapshots don’t change after capture, so this is safe.

Error CodesPermalink for this section

Status	Code	Meaning
400	`validation_error`	Missing or malformed `event_id`.
401	`missing_api_key` / `invalid_api_key`	See Authentication.
403	`tier_restricted`	Tier below Pro.
503	`not_ready`	Closing-line capture is not currently available (e.g., backing store unreachable). Retry.

/api/v1/historical/odds/closing — Enterprise; long-term ClickHouse history beyond the 48h window.
/api/v1/historical/clv — CLV analytics aggregated across opportunities.