Skip to Content
Referência da APIOdds de Fechamento por Data

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/closing

Tier 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âmetroTipoObrigatórioDescrição
datestringSimData no formato YYYY-MM-DD (UTC).
sportstringSimIdentificador do esporte, por exemplo, baseball, basketball, football.
leaguestringSimIdentificador da liga, por exemplo, mlb, nba, nfl.
sportsbookstringSimDe 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_idstringNãoRetorna apenas este evento entre os eventos da data. Omita para receber todos os eventos da data.
include_degradedbooleanNãoPadrã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 -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

CampoTipoDescrição
datestringA data solicitada (YYYY-MM-DD)
sportstringFiltro de esporte aplicado
leaguestringFiltro de liga aplicado
eventsarray | nullEventos de linhas de fechamento que correspondem à data, esporte e liga, apenas com as casas solicitadas. null quando nenhum corresponde.
total_eventsintegerNúmero de eventos na resposta
total_linesintegerNúmero total de linhas de fechamento individuais em todos os eventos e casas

Objeto EventLink permanente para esta seção

CampoTipoDescrição
event_idstringIdentificador canônico do evento
sportstringEsporte
leaguestringLiga
home_teamstringNome do time da casa
away_teamstringNome do time visitante
event_start_timestringHorário de início programado em ISO 8601
captured_atstringTimestamp ISO 8601 da primeira captura de linha de fechamento deste evento
booksobjectMapa de ID da casa de apostas → payload de fechamento por casa (veja abaixo)

Payload por casa (books[<sportsbook>])Link permanente para esta seção

CampoTipoDescrição
oddsarrayEntradas de linha de fechamento desta casa (veja abaixo)
captured_atstringMomento ISO 8601 em que a linha de fechamento desta casa foi capturada
seconds_before_kickoffintegerSegundos 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_triggerstringO que disparou a captura: transition | kickoff | disappearance | evict | backfill (ordem de confiança: transition > kickoff > outros)
is_finalbooleanSe 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.

CampoTipoDescrição
sportsbookstringID da casa de apostas
market_typestringTipo de mercado: moneyline, point_spread, total_runs, player_earned_runs, etc.
market_idstringIdentificador nativo do mercado na casa
selectionstringRótulo da seleção (nome do time, Over/Under, jogador)
selection_typestringhome, away, over, under, etc.
selection_idstringIdentificador nativo da seleção na casa
canonical_keystringChave 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.
linenumberValor do spread ou total (-3.5, 2.5). Omitido em moneylines e outros mercados sem linha.
odds_americanintegerOdds americanas no fechamento
odds_decimalnumberOdds decimais no fechamento
implied_probabilitynumberProbabilidade implícita bruta (com vig)
no_vig_probabilitynumberProbabilidade 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_decimalnumberPreço decimal justo (sem vig) no fechamento. Presente exatamente quando no_vig_probability está presente.
closing_probabilitynumberProbabilidade justa de fechamento calculada pelo método Power (o valor usado para CLV). Omitida quando não havia par complementar disponível.
source_updated_atstringTimestamp 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_namestringNome do jogador — apenas mercados de props de jogador
stat_categorystringCategoria estatística da prop de jogador (por exemplo, earned_runs, total_bases) — apenas mercados de props de jogador
team_sidestringhome | 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_segmentstringTrecho da partida coberto pelo mercado (1st_half, 1st_5_innings, …). Omitido em mercados de jogo completo.
max_betnumberAposta máxima da casa nesta seleção no fechamento — apenas para casas que expõem limites (por exemplo, Pinnacle)
odds_after_kickoffbooleantrue 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

CampoTipoDescrição
sourcestringArmazenamento de origem — "clickhouse"
tier_window_daysstringJanela de retrospectiva — "unlimited" no Enterprise: sem corte móvel, até o início do arquivo em 2026-04-23
filtersobjectEco 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_atstringTimestamp 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

Last updated on