Odds de Fechamento Históricas
Recupere as odds de fechamento capturadas para todos os eventos em uma data específica — o último preço pré-jogo de cada casa de apostas informada (de uma a cinco por requisição) antes de o jogo ficar ao vivo, com probabilidades sem vig (devigged).
GET /api/v1/historical/odds/closingTier Enterprise obrigatório. Este endpoint é controlado pelo recurso history, disponível apenas no tier Enterprise. Tiers inferiores recebem um erro 403 tier_restricted.
As linhas de fechamento são capturadas em tempo real nas transições is_live false→true e persistidas no ClickHouse. Não há limite de janela móvel: toda linha de fechamento armazenada desde o início do arquivo, em 23 de abril de 2026, está disponível (meta.tier_window_days é "unlimited"). Datas anteriores não retornam eventos, porque nada foi capturado antes disso.
AutenticaçãoLink permanente para esta seção
Requer API key. Tier Enterprise obrigatório (recurso history).
Parâmetros de ConsultaLink permanente para esta seção
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
date | string | Sim | Data no formato YYYY-MM-DD (UTC). |
sport | string | Sim | Identificador do esporte, por exemplo, baseball, basketball, football. |
league | string | Sim | Identificador da liga, por exemplo, mlb, nba, nfl. |
sportsbook | string | Sim | De um a cinco IDs de casas de apostas, por exemplo, pinnacle ou pinnacle,draftkings. Envie uma lista separada por vírgulas, repita o parâmetro (sportsbook=pinnacle&sportsbook=draftkings) ou as duas coisas. Duplicatas contam uma vez. Mais de cinco casas retorna 400. |
event_id | string | Não | Retorna apenas este evento entre os eventos da data. Omita para receber todos os eventos da data. |
include_degraded | boolean | Não | Padrão false. Linhas cujo preço de “fechamento” na verdade derivou durante o jogo (cotado bem depois do início) são excluídas por padrão. Envie true para incluí-las — cada uma vem marcada com odds_after_kickoff: true para que você possa excluí-la do cálculo de CLV. |
date, sport, league e sportsbook são obrigatórios. A resposta é filtrada para eventos que correspondam exatamente ao esporte e liga na data UTC informada, e cada evento traz apenas as casas informadas. Para mais de cinco casas, faça uma requisição por grupo de cinco.
Exemplos de RequisiçõesLink permanente para esta seção
cURL
curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/closing?date=2026-06-30&sport=baseball&league=mlb&sportsbook=pinnacle,draftkings" \
-H "X-API-Key: YOUR_API_KEY"RespostaLink permanente para esta seção
Sucesso (200)Link permanente para esta seção
Esta é uma resposta encapsulada: { success, data, meta }.
Resposta real à requisição acima (reduzida a um evento, moneyline + uma prop de jogador; uma resposta real traz todos os mercados capturados para cada evento da data, para cada casa informada):
{
"success": true,
"data": {
"date": "2026-06-30",
"sport": "baseball",
"league": "mlb",
"events": [
{
"event_id": "mlb_phillies_pirates_2026-06-30_b3",
"sport": "baseball",
"league": "mlb",
"home_team": "Philadelphia Phillies",
"away_team": "Pittsburgh Pirates",
"event_start_time": "2026-06-30T22:40:00Z",
"captured_at": "2026-06-30T22:42:56.227Z",
"books": {
"pinnacle": {
"captured_at": "2026-07-01T02:18:19.094Z",
"seconds_before_kickoff": -13099,
"capture_trigger": "evict",
"is_final": true,
"odds": [
{
"sportsbook": "pinnacle",
"market_type": "moneyline",
"market_id": "1632103992_moneyline_0",
"selection": "Pittsburgh Pirates",
"selection_type": "away",
"selection_id": "away",
"canonical_key": "mlb_phillies_pirates_2026-06-30_b3:moneyline:away",
"odds_american": 182,
"odds_decimal": 2.82,
"implied_probability": 0.35460992907801414,
"no_vig_probability": 0.34684612016316746,
"fair_close_decimal": 2.88312292358804,
"closing_probability": 0.3417584456103625,
"source_updated_at": "2026-06-30T21:22:43.926672195Z",
"max_bet": 15000,
"team_side": "away"
}
]
},
"draftkings": {
"captured_at": "2026-06-30T22:42:58.116Z",
"seconds_before_kickoff": -13099,
"capture_trigger": "backfill",
"is_final": true,
"odds": [
{
"sportsbook": "draftkings",
"market_type": "moneyline",
"market_id": "1_85320694",
"selection": "PIT Pirates",
"selection_type": "away",
"selection_id": "0ML85320694_3",
"canonical_key": "mlb_phillies_pirates_2026-06-30_b3:moneyline:away",
"odds_american": 191,
"odds_decimal": 2.91,
"implied_probability": 0.3436426116838488,
"no_vig_probability": 0.32880208077734696,
"fair_close_decimal": 3.04134328358209,
"closing_probability": 0.3170282527982699,
"source_updated_at": "2026-06-30T20:43:21.398Z",
"team_side": "away"
},
{
"sportsbook": "draftkings",
"market_type": "player_earned_runs",
"market_id": "347277229",
"selection": "Over",
"selection_type": "over",
"selection_id": "0QA347277229#2197684044_13L84240Q1-339433858Q20",
"canonical_key": "mlb_phillies_pirates_2026-06-30_b3:player_earned_runs:chandler_bub:over:2.5",
"line": 2.5,
"odds_american": -136,
"odds_decimal": 1.7352941176470589,
"implied_probability": 0.576271186440678,
"no_vig_probability": 0.5379072681704261,
"fair_close_decimal": 1.8590564938846825,
"closing_probability": 0.5420932938608679,
"source_updated_at": "2026-06-30T22:39:57.090381809Z",
"player_name": "Bubba Chandler",
"stat_category": "earned_runs"
}
]
}
}
}
],
"total_events": 15,
"total_lines": 6096
},
"meta": {
"source": "clickhouse",
"tier_window_days": "unlimited",
"filters": {
"sport": "baseball",
"league": "mlb",
"date": "2026-06-30",
"sportsbook": ["pinnacle", "draftkings"],
"event_id": null
},
"updated_at": "2026-11-07T12:13:58.317932502Z"
}
}data.events é null (não []) quando nenhum evento corresponde aos filtros naquela data.
Respostas de ErroLink permanente para esta seção
400 Erro de Validação
{
"error": {
"code": "validation_error",
"message": "sportsbook parameter is required"
}
}Outras mensagens 400, todas com o código validation_error: sport parameter is required, league parameter is required, date parameter is required in YYYY-MM-DD format, sportsbook accepts at most 5 books per request, got N, event_id exceeds maximum length e Invalid event_id format.
403 Tier Restrito (tier incorreto)
{
"error": {
"code": "tier_restricted",
"message": "This endpoint requires Enterprise tier or higher",
"docs": "https://sharpapi.io/pricing",
"tier": "pro",
"required_tier": "enterprise"
}
}Campos da RespostaLink permanente para esta seção
Objeto dataLink permanente para esta seção
| Campo | Tipo | Descrição |
|---|---|---|
date | string | A data solicitada (YYYY-MM-DD) |
sport | string | Filtro de esporte aplicado |
league | string | Filtro de liga aplicado |
events | array | null | Eventos de linhas de fechamento que correspondem à data, esporte e liga, apenas com as casas solicitadas. null quando nenhum corresponde. |
total_events | integer | Número de eventos na resposta |
total_lines | integer | Número total de linhas de fechamento individuais em todos os eventos e casas |
Objeto EventLink permanente para esta seção
| Campo | Tipo | Descrição |
|---|---|---|
event_id | string | Identificador canônico do evento |
sport | string | Esporte |
league | string | Liga |
home_team | string | Nome do time da casa |
away_team | string | Nome do time visitante |
event_start_time | string | Horário de início programado em ISO 8601 |
captured_at | string | Timestamp ISO 8601 da primeira captura de linha de fechamento deste evento |
books | object | Mapa de ID da casa de apostas → payload de fechamento por casa (veja abaixo) |
Payload por casa (books[<sportsbook>])Link permanente para esta seção
| Campo | Tipo | Descrição |
|---|---|---|
odds | array | Entradas de linha de fechamento desta casa (veja abaixo) |
captured_at | string | Momento ISO 8601 em que a linha de fechamento desta casa foi capturada |
seconds_before_kickoff | integer | Segundos antes do início no momento da captura. Negativo quando a captura ocorreu depois do início programado — levemente negativo em capturas transition/kickoff, possivelmente horas negativo em capturas evict/backfill (as odds continuam sendo os últimos preços pré-jogo vistos). |
capture_trigger | string | O que disparou a captura: transition | kickoff | disappearance | evict | backfill (ordem de confiança: transition > kickoff > outros) |
is_final | boolean | Se esta é a captura de fechamento final/travada da casa |
Entrada de linha de fechamento (books[<sportsbook>].odds[])Link permanente para esta seção
Campos opcionais são omitidos do JSON (não serializados como null) quando não se aplicam — use verificações de presença ('line' in entry / .get()) em vez de verificações de null.
| Campo | Tipo | Descrição |
|---|---|---|
sportsbook | string | ID da casa de apostas |
market_type | string | Tipo de mercado: moneyline, point_spread, total_runs, player_earned_runs, etc. |
market_id | string | Identificador nativo do mercado na casa |
selection | string | Rótulo da seleção (nome do time, Over/Under, jogador) |
selection_type | string | home, away, over, under, etc. |
selection_id | string | Identificador nativo da seleção na casa |
canonical_key | string | Chave estável entre casas para junção: <event_id>:<market_type>[:<player>]:<selection_type>[:<line>]. Omitida em uma pequena fração de linhas em que não foi possível derivar uma chave canônica. |
line | number | Valor do spread ou total (-3.5, 2.5). Omitido em moneylines e outros mercados sem linha. |
odds_american | integer | Odds americanas no fechamento |
odds_decimal | number | Odds decimais no fechamento |
implied_probability | number | Probabilidade implícita bruta (com vig) |
no_vig_probability | number | Probabilidade justa sem vig, devigged proporcionalmente (0.0–1.0), dentro do par de mercados complementares desta casa. Omitida quando as seleções capturadas não formam um grupo complementar completo (por exemplo, mercados de múltiplas vias, contraparte ausente). |
fair_close_decimal | number | Preço decimal justo (sem vig) no fechamento. Presente exatamente quando no_vig_probability está presente. |
closing_probability | number | Probabilidade justa de fechamento calculada pelo método Power (o valor usado para CLV). Omitida quando não havia par complementar disponível. |
source_updated_at | string | Timestamp ISO 8601 em que o registro de odds de origem foi confirmado como atual na origem pela última vez (última vez visto ativo, não a última mudança de preço) |
player_name | string | Nome do jogador — apenas mercados de props de jogador |
stat_category | string | Categoria estatística da prop de jogador (por exemplo, earned_runs, total_bases) — apenas mercados de props de jogador |
team_side | string | home | away | draw — o eixo de time para linhas ancoradas a um time (moneylines, totais de time). Omitido quando a linha não está ancorada a um time. |
market_segment | string | Trecho da partida coberto pelo mercado (1st_half, 1st_5_innings, …). Omitido em mercados de jogo completo. |
max_bet | number | Aposta máxima da casa nesta seleção no fechamento — apenas para casas que expõem limites (por exemplo, Pinnacle) |
odds_after_kickoff | boolean | true quando o preço da linha mudou pela última vez bem depois do início (deriva ao vivo, não um fechamento real). Essas linhas só aparecem com include_degraded=true; exclua-as do cálculo de CLV. |
Objeto metaLink permanente para esta seção
| Campo | Tipo | Descrição |
|---|---|---|
source | string | Armazenamento de origem — "clickhouse" |
tier_window_days | string | Janela de retrospectiva — "unlimited" no Enterprise: sem corte móvel, até o início do arquivo em 2026-04-23 |
filters | object | Eco dos filtros aplicados: sport, league, date, sportsbook (um array das casas, na ordem da requisição) e event_id (null quando não enviado) |
updated_at | string | Timestamp ISO 8601 da resposta |
Casos de UsoLink permanente para esta seção
Análise de CLV: Compare no_vig_probability / closing_probability entre as casas em relação à Pinnacle. Uma casa soft com probabilidade justa maior no lado que você apostou fechou mais frouxa — CLV positivo.
Auditoria de line shopping: Recupere linhas de fechamento de várias casas (até cinco por requisição) para entender onde havia valor disponível no fechamento (use canonical_key para alinhar a mesma seleção entre casas).
Calibração de modelo: Use implied_probability e no_vig_probability como verdade histórica para calibrar seus próprios modelos de probabilidade.
Endpoints RelacionadosLink permanente para esta seção
- Closing Line Value (CLV) — Agregações de CLV% agrupadas por casa de apostas, esporte, liga ou dia
- Closing Line — Captura de fechamento atual ou mais recente (Pro+, tempo real)
- Snapshot de Odds — Odds atuais em tempo real
- Oportunidades +EV — Apostas com valor esperado positivo em tempo real