Skip to Content
Referência da APISnapshot de Odds

Snapshot de Odds

Obtenha um snapshot das odds atuais das casas de apostas.

GET /api/v1/odds

Alterado na v3.0.0: os antigos campos odds_changed_at, last_seen_at e wire_received_at foram removidos — leia timestamp (entrega / frescor do feed) em vez disso. Desde novembro de 2026, price_updated_at indica quando o preço se moveu pela última vez.

AutenticaçãoLink permanente para esta seção

Requer API key. Disponível para todos os tiers.

As casas de apostas retornadas em seus resultados dependem do seu tier de assinatura. Usuários do tier Free recebem odds apenas da DraftKings e FanDuel. Veja Acesso a Casas por Tier abaixo.

Parâmetros de QueryLink permanente para esta seção

ParâmetroTipoPadrãoDescrição
sportsbookstringpermitidas pelo tierIDs de casas de apostas separados por vírgula (ex.: draftkings,fanduel). Limites de tier são aplicados.
sportstringtodosFiltrar por esporte(s), separados por vírgula (ex.: basketball, football). Suporta aliases de categoria. Apenas IDs de esporte; um ID de liga como nba vai em league (detalhes).
leaguestringtodasFiltrar por liga(s), separadas por vírgula (ex.: nba, nfl, nhl)
marketstringtodosFiltrar por tipo(s) de mercado, separados por vírgula. Suporta aliases de categoria (main, spread, total, props) ou tipos exatos (point_spread, player_points).
event_idstring—Filtrar por ID(s) de evento, separados por vírgula
is_liveboolean—true = apenas ao vivo, false = apenas pré-jogo, omitir = ambos
min_oddsnumber—Filtro de odds americanas mínimas (ex.: -110)
max_oddsnumber—Filtro de odds americanas máximas (ex.: +200)
group_bystring—Agrupar resultados por campo (ex.: event)
statestring—Código de estado dos EUA apenas para o destino do deep link; não filtra odds nem retorna preços específicos por estado. Aceita os 50 códigos de estados dos EUA e dc; códigos não vazios não aceitos (incluindo on) retornam 400 invalid_filter. Quando definido, as URLs deep_link incluem ?state=XX; valores omitidos ou vazios não geram ?state=, e o redirecionamento aplica então seu próprio padrão pa. Afeta apenas casas com URLs dependentes do estado (BetMGM, Caesars, BetRivers).
limitinteger50Máximo de resultados por página (máx. 200)
offsetinteger0Offset de paginação. Deve ser ≤ 500. Valores acima de 500 retornam 400 offset_too_large — use cursor para paginação mais profunda. Pode produzir linhas duplicadas quando dados ao vivo são atualizados entre requisições.
cursorstring—Cursor opaco do next_cursor em uma resposta anterior. Necessário para paginação profunda (além do offset 500) e recomendado para qualquer varredura de múltiplas páginas — estável diante de mudanças de dados ao vivo. Tem precedência sobre offset quando ambos são fornecidos.

Use valores separados por vírgula para filtrar por múltiplas casas de apostas: sportsbook=draftkings,fanduel,betmgm

Aliases de Categoria de MercadoLink permanente para esta seção

Em vez de listar tipos de mercado individuais, você pode usar um alias de categoria para corresponder a um grupo de mercados relacionados. Aliases e tipos exatos podem ser misturados livremente em uma lista separada por vírgulas.

AliasExpande para
mainmoneyline, point_spread, total_points
spreadpoint_spread, puck_line, run_line, set_handicap
totaltotal_points, total_goals, total_runs, total_games, total_rounds, team_total
propsTodos os tipos de mercado player_* (correspondência por prefixo)
# Buscar todos os mercados "main" (moneyline + spreads + totals) curl "https://api.sharpapi.io/api/v1/odds?league=nba&market=main" \ -H "X-API-Key: YOUR_API_KEY" # Misturar um alias com um tipo exato curl "https://api.sharpapi.io/api/v1/odds?league=nfl&market=spread,moneyline" \ -H "X-API-Key: YOUR_API_KEY" # Todos os mercados de player props curl "https://api.sharpapi.io/api/v1/odds?league=nba&market=props" \ -H "X-API-Key: YOUR_API_KEY"

O alias props usa correspondência por prefixo, portanto inclui automaticamente qualquer tipo de mercado começando com player_ (ex.: player_points, player_rebounds, player_assists, player_strikeouts, etc.).

Exemplos de RequisiçãoLink permanente para esta seção

curl -X GET "https://api.sharpapi.io/api/v1/odds?league=nba&sportsbook=draftkings&market=moneyline" \ -H "X-API-Key: YOUR_API_KEY"

PaginaçãoLink permanente para esta seção

Use paginação baseada em cursor para varreduras de múltiplas páginas. O endpoint /odds serve dados ao vivo que são atualizados a cada ~15 segundos. Com paginação baseada em offset, linhas podem mudar de posição entre requisições, causando duplicatas nos limites de página. A paginação baseada em cursor ancora cada página ao último item visto — sem desvios.

Cada resposta inclui tanto next_cursor (estável) quanto next_offset (legado) no objeto pagination. Para varreduras sequenciais do conjunto completo de dados, sempre use next_cursor.

# Primeira página — sem necessidade de cursor curl "https://api.sharpapi.io/api/v1/odds?league=nfl&limit=200" \ -H "X-API-Key: YOUR_API_KEY" # Páginas subsequentes — passe next_cursor da resposta anterior curl "https://api.sharpapi.io/api/v1/odds?league=nfl&limit=200&cursor=eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0" \ -H "X-API-Key: YOUR_API_KEY"

Ordem dos resultadosLink permanente para esta seção

Os resultados são retornados em ordem cronológica por hora de início do evento — primeiro os eventos já em andamento e os que começam mais cedo, depois os posteriores. Eventos sem hora de início no feed são ordenados por último.

Uma única página é, portanto, uma fatia da programação, não uma amostra de todo o conjunto de resultados. Uma casa de apostas sem jogos começando dentro do trecho da programação que aquela página cobre não aparecerá nela, mesmo que tenha muitas linhas correspondentes mais tarde no mesmo dia — esse é o comportamento esperado, não uma falha de cobertura. Para verificar se uma casa oferece um mercado, filtre com ?sportsbook= ou restrinja com ?league= em vez de ler uma primeira página sem filtro.

Em uma página com linhas, é isso que meta.books informa: uma casa listada em in_scope sem entrada em in_page não retornou linhas naquela página — geralmente porque seus jogos ficam fora do trecho da programação que aquela página cobre, e não porque ela não oferece o mercado.

Cursores são opacos — não os analise nem os construa. Eles codificam a posição de ordenação do último item na página atual e só são válidos para os mesmos parâmetros de filtro.

?offset=N continua funcionando para paginação rasa (até offset 500) e é apropriado para requisições de página única ou acesso direto por posição. Além de 500, a API retorna 400 offset_too_large — caso contrário, o servidor teria que ordenar todo o conjunto filtrado de resultados a cada página, o que é muito mais barato evitar do que otimizar por requisição. Use cursor para qualquer coisa mais profunda.

{ "error": { "code": "offset_too_large", "message": "offset must be <= 500; use `cursor=` from the previous response for deeper pagination", "max_offset": 500 } }

RespostaLink permanente para esta seção

Sucesso (200)Link permanente para esta seção

{ "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-01-26T19:00:00Z", "timestamp": "2026-01-26T02:10:24.125Z", "price_updated_at": "2026-01-26T01:52:41.380Z", "is_live": false }, { "id": "draftkings_33483153_moneyline_PHI", "sportsbook": "draftkings", "event_id": "33483153", "sport": "basketball", "league": "nba", "home_team": "PHI 76ers", "away_team": "PHO Suns", "market_type": "moneyline", "selection": "PHI 76ers", "selection_type": "home", "odds_american": 130, "odds_decimal": 2.30, "odds_probability": 0.4348, "line": null, "event_start_time": "2026-01-26T19:00:00Z", "timestamp": "2026-01-26T02:10:24.125Z", "price_updated_at": "2026-01-26T01:52:41.380Z", "is_live": false } ], "meta": { "count": 2, "total": 3095, "books_available": ["draftkings", "fanduel", "betmgm", "caesars", "pinnacle"], "books_returned": ["draftkings"], "pagination": { "limit": 50, "offset": 0, "has_more": true, "next_offset": 50, "next_cursor": "eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0" }, "updated_at": "2026-01-26T02:10:37.846Z", "filters": { "league": "nba", "sportsbook": "draftkings", "market": "moneyline" } } }

Resultados vazios (200): meta.storeLink permanente para esta seção

Uma página vazia — 200 com "data": [] e "count": 0 — pode significar duas coisas diferentes: seus filtros não corresponderam a nada, ou a instância que respondeu não tinha nada carregado naquele momento (por exemplo, durante uma troca de store). Desde setembro de 2026 a resposta diz qual é o caso. Sempre que /odds retorna zero linhas, um bloco meta.store é adicionado, e reason é o campo no qual você deve se basear:

{ "data": [], "pagination": { "limit": 50, "offset": 0, "count": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-09-07T02:41:18.552Z", "meta": { "store": { "generation": 5019, "ready": true, "books": 39, "rows": 810137, "reason": "no_match" } } }
reasonSignificadoO que fazer
warmingA instância que respondeu não concluiu nenhum ciclo de atualização desde a última mudança de modo — nada foi carregado aindaTentar novamente
store_emptyA instância está pronta, mas não contém nenhuma linha de odds, por exemplo no meio de uma troca de storeTentar novamente — não trate a página vazia como definitiva
no_matchA instância está pronta e com dados; seus filtros não corresponderam a nadaDefinitivo — tentar novamente não mudará a resposta
CampoTipoSignificado
generationintegerGeração do snapshot a partir da qual esta resposta foi servida. 0 significa que nada foi carregado desde o início do processo.
readybooleanPelo menos um ciclo de atualização foi concluído desde a última mudança de modo da instância.
booksintegerCasas de apostas presentes no snapshot a partir do qual esta resposta foi servida, independentemente dos seus filtros.
rowsintegerLinhas de odds mantidas por esse snapshot, independentemente dos seus filtros.
reasonstringwarming, store_empty ou no_match — veja acima.
event_statusstringPresente apenas quando a página está vazia porque o único evento pelo qual você filtrou com event_id terminou: final (uma conclusão registrada está retida — o mesmo registro que /events/{eventId} serve como status: "final") ou gone (o evento saiu da programação na última hora, aproximadamente, sem uma conclusão registrada — a mesma condição sob a qual /events/{eventId} responde 410 Gone). Omitido nos demais casos. Veja Eventos finalizados abaixo.
completed_atstringAcompanha apenas event_status: "final" — o instante RFC 3339 em que a conclusão foi detectada, idêntico ao completed_at de /events/{eventId}. Nunca é enviado com gone.
  • Presente apenas em resultados vazios. Uma resposta com linhas é idêntica byte a byte à anterior e não carrega meta.store; parsers que leem data + pagination + updated_at continuam funcionando.
  • books e rows descrevem o snapshot inteiro, não a sua consulta — rows: 810137 é evidência de que o store estava populado, não uma contagem do que você teria obtido.
  • Consultas que se resolvem para duas ou mais casas de apostas também carregam meta.books (o escopo de casas resolvido: in_scope e as contagens in_page por casa); meta.store é adicionado ao lado dele. O mesmo vale para a página vazia de uma seleção de casas do dashboard que não se resolveu para nenhuma casa — veja Seleção de casas vazia abaixo.
  • Um valor desconhecido de league ou sportsbook é rejeitado com 400 invalid_filter em vez de respondido com uma página vazia. Os demais filtros não são validados contra o catálogo: um market_type ou event_id que não existe em lugar nenhum retorna uma página vazia comum com reason: "no_match".

Eventos finalizados: event_status e completed_atLink permanente para esta seção

Um cliente que continua consultando /odds?event_id=<id> depois que o jogo termina recebe uma página vazia definitiva — reason: "no_match" é verdadeiro, mas não diz por que nada correspondeu. Quando a página está vazia porque o único evento pelo qual você filtrou terminou, meta.store também diz isso. Esta é a resposta real para um jogo da MLB que havia terminado na mesma noite (uma consulta de uma única casa, para que o corpo fique curto — uma consulta com várias casas carrega meta.books ao lado, como acima):

GET /api/v1/odds?event_id=mlb_twins_whitesox_2026-09-06_b3&sportsbook=pinnacle&limit=1
{ "data": [], "pagination": { "limit": 1, "offset": 0, "count": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-09-07T10:04:34.951684418Z", "meta": { "store": { "generation": 13456, "ready": true, "books": 39, "rows": 947879, "reason": "no_match", "event_status": "final", "completed_at": "2026-09-07T02:09:37Z" } } }

/events/mlb_twins_whitesox_2026-09-06_b3 retornou status: "final" com o mesmo completed_at no mesmo instante — os dois endpoints leem o mesmo registro, portanto não podem discordar.

event_statusSignificadoO que fazer
finalUma conclusão registrada está retida para o evento; completed_at é o momento em que ela foi detectada.Pare de consultar — o evento acabou; obtenha o resultado em /events/{eventId}
goneO evento saiu da programação na última hora, aproximadamente, sem uma conclusão registrada — adiado, cancelado ou encerrado tão recentemente que nenhum resultado foi registrado ainda. É a mesma condição sob a qual /events/{eventId} responde 410 Gone, e não afirma que o evento terminou.Pare de consultar as odds; verifique /events/{eventId} mais tarde para ver se há resultado

O sinal só é anexado quando todas as condições a seguir são satisfeitas — caso contrário o bloco mantém sua forma comum e nenhuma das duas chaves está presente:

  • a requisição filtrou por exatamente um event_id (uma lista separada por vírgulas não recebe sinal — o campo é singular);
  • a página está vazia com reason: "no_match" (uma página warming ou store_empty nunca o carrega — o vazio é do store, e reason já diz para tentar novamente);
  • sabe-se que o evento terminou. Um evento ainda ao vivo ou futuro, ou um id que não existe em lugar nenhum, recebe um no_match comum sem event_status — portanto uma consulta de um único id respondida sem ele significa um id errado ou um evento que não terminou.

Um evento finalizado cujas odds ainda estão em cache retorna essas linhas normalmente; o sinal aparece quando a página se esvazia. completed_at é o momento em que a conclusão foi detectada — normalmente alguns minutos depois de o evento sair do feed ao vivo — e não o apito final; a mesma ressalva de completed_at em /events. O código de status nunca muda: um cliente que consulta um evento ao longo de toda a sua vida continua recebendo 200.

Seleção de casas vazia: meta.books.reasonLink permanente para esta seção

Se a seleção de casas de apostas salva no seu dashboard não se resolve para nada — todas as casas selecionadas estão ausentes do snapshot atual ou não estão incluídas no seu tier —, uma requisição a /odds sem filtros é respondida com uma página vazia. O store está bem; a seleção é o motivo, e a resposta o nomeia. meta.books — normalmente presente apenas em consultas que se resolvem para duas ou mais casas — é emitido com um escopo vazio, reason: "selection_disjoint" e selected, a seleção que não se resolveu para nada (IDs canônicos de casa, ordenados):

{ "data": [], "pagination": { "limit": 50, "offset": 0, "count": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-09-07T10:04:34.951684418Z", "meta": { "books": { "in_scope": [], "in_page": {}, "reason": "selection_disjoint", "selected": ["betway", "bwin"] }, "store": { "generation": 13454, "ready": true, "books": 39, "rows": 947919, "reason": "no_match" } } }
  • meta.books.reason tem precedência. meta.store continua aparecendo ao lado com reason: "no_match" — correto para o store (ele está populado), mas não é a causa. Quando meta.books.reason está presente, esse é o motivo da página vazia; tentar novamente não mudará a resposta. Corrija a seleção no seu dashboard, ou faça upgrade se as casas que você selecionou exigirem um tier superior.
  • in_scope e in_page estão presentes e vazios ([] / {}, nunca null). O único valor de reason hoje é selection_disjoint.
  • Emitido apenas quando a seleção é de fato a causa: a requisição não trazia um filtro sportsbook= explícito, você tem uma seleção no dashboard e seu tier sozinho teria se resolvido para pelo menos uma casa. Nunca aparece no tier Free (que sempre serve DraftKings e FanDuel, independentemente da seleção) nem com um store vazio ou em aquecimento — essas páginas são explicadas por meta.store.
  • Com um filtro sportsbook= explícito, a mesma divergência é rejeitada em vez de respondida com uma página vazia: 403 tier_restricted, 403 book_not_selected ou 503 book_unavailable.
  • Páginas que se resolvem para uma ou mais casas não mudam: o bloco de duas ou mais casas não carrega reason nem selected, e um escopo de uma única casa não carrega meta.books de forma alguma.

Cabeçalhos de RespostaLink permanente para esta seção

X-RateLimit-Limit: 300 X-RateLimit-Remaining: 299 X-RateLimit-Reset: 1737853200 X-Data-Delay: 0 X-Request-Id: req_abc123def456
CabeçalhoDescrição
X-RateLimit-LimitMáximo de requisições por minuto para o seu tier
X-RateLimit-RemainingRequisições restantes na janela atual
X-RateLimit-ResetTimestamp Unix de quando o rate limit é redefinido
X-Data-DelayAtraso dos dados em segundos (0 para tempo real, 60 para o tier Free)
X-Request-IdIdentificador único da requisição para depuração

Respostas de ErroLink permanente para esta seção

401 Unauthorized

Se nenhuma chave for enviada, retorna missing_api_key; uma chave inválida retorna 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://docs.sharpapi.io/en/authentication" } }

403 Tier Restricted

Um filtro sportsbook= que nomeia um sportsbook acima do seu plano é recusado com este corpo. Os sportsbooks solicitados, os que a sua chave pode consultar e required_tier ficam em details (este corpo não tem tier no nível superior), e upgrade / upgrade_note nomeiam o plano que os libera (Campos de upgrade). Compare code, não o texto de message.

{ "error": { "code": "tier_restricted", "message": "the requested sportsbooks require sharp tier or higher; your current plan is pro. Upgrade to Sharp for $399/mo, with 25 sportsbooks of your choice: https://sharpapi.io/dashboard/billing/upgrade/sharp", "details": { "field": "sportsbook", "requested": ["pinnacle"], "allowed": ["betmgm", "caesars", "draftkings", "fanduel"], "required_tier": "sharp" }, "upgrade": "https://sharpapi.io/dashboard/billing/upgrade/sharp?utm_source=api&utm_medium=403&utm_campaign=sharp-plan-books", "upgrade_note": "Upgrade to Sharp for $399/mo, with 25 sportsbooks of your choice" } }

429 Rate Limited

{ "error": { "code": "rate_limited", "message": "Rate limit exceeded. Retry after 45 seconds.", "docs": "https://docs.sharpapi.io/en/authentication#rate-limits" } }

Schema do Objeto OddsLink permanente para esta seção

CampoTipoDescrição
idstringIdentificador único de odds
sportsbookstringID da casa de apostas (ex.: draftkings)
event_idstringIdentificador do evento
sportstringSlug do esporte (ex.: basketball, football)
leaguestringSlug da liga (ex.: nba, nfl)
home_teamstringNome do time mandante
away_teamstringNome do time visitante
market_typestringmoneyline, spread, total, player_prop, etc.
selectionstringA seleção (nome do time, Over/Under, nome do jogador)
selection_typestringIdentificador canônico do lado. Veja Tipos de seleção abaixo para o enum completo, incluindo formas compostas (ex.: home_over) emitidas em mercados multieixo.
team_sidestring|undefinedDica bruta de lado do time vinda do adaptador — um dentre home, away, draw. Útil quando selection_type carrega um valor composto (ex.: home_over) e você quer apenas o eixo de time sem precisar fazer parsing. Ausente quando o adaptador não o carimbou.
odds_americannumberOdds americanas (ex.: -110, +150)
odds_decimalnumberOdds decimais (ex.: 1.909)
odds_probabilitynumberProbabilidade implícita (ex.: 0.5238)
linenumber | nullValor da linha de spread ou total (null para moneyline)
is_alternate_lineboolean|undefinedtrue quando o line desta linha difere da linha principal própria desta casa de apostas para a sua coorte — a coorte é (event, market_type, eixo de seleção), resolvida por casa de apostas. A linha principal de uma casa é a que ela oferece nos dois sentidos e cujas duas odds estão mais próximas de um mercado equilibrado; os dois lados dessa linha contam como principais. Uma casa que não oferece nenhuma linha nos dois sentidos (uma escada de um lado só) recebe a linha que mais casas oferecem, ou o seu próprio degrau mais bem classificado quando não oferece essa. Duas casas podem ter linhas principais diferentes no mesmo mercado. Sempre false para mercados sem linha (moneyline, outright). Disponível em /odds e em /opportunities/ev. Use para separar snapshots de linha principal e linhas alternativas.
event_start_timestringHora de início do evento em ISO 8601
timestampstringHorário ISO 8601 em que a SharpAPI atualizou esta odd pela última vez através do seu pipeline — avança a cada ciclo de ingestão. É um sinal de frescor / liveness do feed; não é quando o preço mudou pela última vez.
price_updated_atstring|undefinedHorário ISO 8601 em que o preço desta odd foi atualizado pela última vez. Ele se move quando mudam o preço, a linha, o status ao vivo ou a suspensão, e quando mudam o livro de ordens ou o tamanho disponível (melhor bid ou ask, best_bid_liquidity, total_liquidity, max_bet). Ele não se move quando a SharpAPI relê uma odd sem mudanças, então distingue um preço congelado há horas de um que acabou de se mover. Normalmente é o horário em que a SharpAPI viu a mudança pela primeira vez; para alguns books que enviam um horário de mudança próprio confiável, é o horário do book. Omitido quando a odd não tem horário de mudança. Veja Entendendo o campo timestamp.
is_livebooleanSe o preço desta casa de apostas está ao vivo. Para o status do próprio jogo, use status em /events.
is_player_propbooleantrue em qualquer mercado no nível do jogador — um preço sobre um único jogador específico, e não sobre um time ou a partida como um todo. Além dos tipos canônicos player_* (player_points, player_goals), abrange os mercados de marcador de gol (anytime_goal_scorer, first_goal_scorer, anytime_touchdown_scorer), os mercados de jogador limitados a um período ou segmento (1st_quarter_player_points, 1st_half_player_goals) e os mercados most_*_player. Mercados no nível da competição que apenas soam como um superlativo (most_corners) não são marcados. Mais amplo que o alias de mercado props, que continua sendo uma correspondência por prefixo player_. ⚠ selection não tem a mesma forma em todas as linhas marcadas: nos tipos player_* carrega o lado (Over, Under, Yes, No); nos demais mercados no nível do jogador carrega o rótulo da própria casa de apostas, que normalmente nomeia o jogador.
event_uuidstring|undefinedUUID canônico estável do evento do atlas do SharpAPI, quando o evento está mapeado. Enquanto event_id carrega o identificador primário do adaptador (frequentemente o da casa de apostas originadora), event_uuid é um hash estável entre feeds para joins cross-feed. Ausente para eventos não mapeados.
external_event_idstring|undefinedO ID de evento nativo da própria casa de apostas, quando distinto de event_id. Útil para vincular linhas de volta à UI ou API da casa de apostas.
deep_linkstring|undefinedURL resolvedora apontando para a página de evento ou bilhete da casa de apostas. Passe state= (ex.: state=nj) na requisição para rotear via subdomínios específicos por estado em casas que os exigem (BetMGM, Caesars, BetRivers).
market_idstring|undefinedIdentificador nativo de mercado da casa de apostas. Algumas casas não o expõem — ausente quando desconhecido. O escopo dele é o da própria casa: na maioria das casas os dois lados de uma linha o compartilham, mas algumas usam um único market_id para toda uma escada de linhas, e outras colocam nele a linha com sinal, de modo que os dois lados de um spread carregam ids diferentes. Para parear os dois lados de uma linha, combine sportsbook, event_id, market_type, player_name em props e a linha (o mesmo valor em um total, o sinal oposto em um spread), com o selection_type oposto; não pareie apenas por market_id.
external_market_idstring|undefinedUm identificador de mercado que é o mesmo em todos os estados dos EUA em que a casa de apostas opera. Presente apenas em linhas do FanDuel — o FanDuel gera uma market_id por estado; external_market_id contém o equivalente independente de estado. Ausente em todas as outras casas. Ao construir um link de cupom do FanDuel por conta própria, use external_market_id junto com selection_id — esse par funciona em qualquer estado. Se você usar o campo deep_link diretamente, nenhuma alteração é necessária: os valores deep_link do FanDuel já são construídos a partir do identificador independente de estado. Leia como external_market_id ?? market_id para tratar o FanDuel e todas as outras casas com uma única expressão.
selection_idstring|undefinedIdentificador nativo de seleção/resultado da casa de apostas. Algumas casas não o expõem — ausente quando desconhecido. Em tênis, tênis de mesa, MMA e boxe, os IDs de SABA, BetOnline, Betsson, SBOBET e Fanatics Markets terminam no nome do jogador em vez do “home”/“away” da casa de apostas (desde 2026-10-30; IDs armazenados antes dessa data não correspondem mais). Em esports, os IDs de SABA e Betsson terminam no nome do time em vez do “home”/“away” da casa de apostas (desde 2026-10-30; IDs armazenados antes dessa data não correspondem mais). Use selection_type para o lado.
player_namestring|undefinedNome do jogador, em mercados no nível do jogador. Está presente nos tipos player_* e também nos mercados de marcador de gol e nos de jogador limitados a um período. ⚠ Não é garantido em todas as linhas marcadas com is_player_prop: true: nos mercados most_*_player ele está ausente e o jogador aparece apenas em selection.
stat_categorystring|undefinedCategoria estatística, ex.: points, rebounds (apenas mercados de player prop)
home_pitcherstring|undefinedApenas MLB. Pitcher abridor do time da casa quando publicado pela casa de apostas.
away_pitcherstring|undefinedApenas MLB. Pitcher abridor do time visitante quando publicado pela casa de apostas.
max_betnumber|undefinedO maior tamanho disponível nesta linha. Em uma casa tradicional (Pinnacle, Circa Sports, SBOBET) é a aposta máxima que ela aceitará, em USD. Em uma casa baseada em exchange é o dinheiro que está ao melhor preço, em size_currency. A ausência significa que o operador não publica nenhum tamanho para a linha; um número — inclusive 0.0 — é um valor real. Em uma casa baseada em exchange este campo aparece apenas enquanto há dinheiro ao melhor preço, então um best_bid_liquidity de 0.0 chega sem max_bet — o mesmo fato, não um contraditório. A Polymarket é a exceção: lá os dois campos descrevem lados opostos do livro; consulte best_bid_liquidity. Consulte Liquidez e limites.
size_currencystring|undefinedCódigo ISO-4217 em que os valores monetários desta linha estão denominados — max_bet, best_bid_liquidity e total_liquidity. GBP na Betfair e na Smarkets, USD em qualquer outra casa que publique um tamanho, e nunca convertido: o valor próprio do operador é repassado na moeda dele. Ausente em linhas sem tamanho e em casas tradicionais, cujo max_bet é um teto de aposta em USD e não um tamanho no livro. Consulte Liquidez e limites.
best_bid_liquiditynumber|undefinedApenas casas baseadas em exchange. Dinheiro que está ao preço publicado — o que um tomador consegue casar sem mover o preço. Denominado em size_currency. 0.0 significa que não há nada ali; a ausência significa que o operador não publica o número. Na Polymarket é o lado do bid, não o preço publicado. Uma linha da Polymarket é precificada a partir do melhor ask; este campo é o dinheiro que está no melhor bid do mesmo resultado, ou seja, o preço do melhor bid vezes as ações em ordens de compra nesse preço, em USD. O tamanho ao preço publicado é max_bet, e os dois raramente coincidem. Na Polymarket este campo nunca é 0.0: se o melhor bid estiver vazio ou seu tamanho ainda não for conhecido, o campo fica ausente.
total_liquiditynumber|undefinedApenas casas baseadas em exchange. Tamanho arriscável somado em todo o livro para esta seleção, não apenas ao melhor preço. Denominado em size_currency. 0.0 significa um livro vazio; a ausência significa que o operador não publica o número. Não derivável de best_bid_liquidity, e algumas casas publicam um sem o outro.
volumenumber|undefinedVolume negociado acumulado nesta seleção, nas unidades nativas da exchange. Apenas exchanges — atualmente Kalshi, Novig e Robinhood. Consulte Liquidez e limites.
volume_24hnumber|undefinedVolume negociado das últimas 24 horas, nas unidades nativas da exchange. Apenas exchanges — atualmente Polymarket e Kalshi.
open_interestnumber|undefinedContratos em aberto pendentes nesta seleção. Apenas exchanges — atualmente Kalshi e Robinhood.
polymarket_resolutionstring|undefinedApenas Polymarket. Status de resolução do oráculo otimista UMA quando o mercado terminou — um dentre settled_normal, voided, disputed, proposed, unknown. Ausente em mercados Polymarket ainda ao vivo e em todas as casas não-Polymarket.

Tipos de seleçãoLink permanente para esta seção

selection_type carrega o identificador canônico de lado para cada selection. A maioria dos mercados é de duas vias (ex.: moneyline, point spread, total) e emite um dos valores simples abaixo. Um pequeno conjunto de mercados multieixo (dupla chance no futebol, BTTS combinado, resultado × O/U, round betting de MMA, set betting de tênis, placar exato, etc.) codifica dois resultados por seleção e emite valores compostos unidos por _.

FamíliaValoresOnde aparecem
Duas vias (lado do time)home, awaymoneyline, point_spread, puck_line, run_line, set_handicap, a maioria dos mercados por período
Duas vias (direção da linha)over, undertotal_points, total_goals, total_runs, total_games, total_rounds, todos os props player_*_o_u
Duas vias (sim/não)yes, nobinary, mercados estilo prop sim/não, resultados de exchange “back/lay”, mercados de previsão Polymarket
Duas vias (paridade)even, oddMercados de paridade de totais (ex.: total de pontos par/ímpar)
Três viasdrawMoneyline a três vias (1X2 do futebol), lado complementar do draw-no-bet, “sem gol” em next_goal
Composto (time × O/U)home_over, home_under, away_over, away_under, e draw_over, draw_under no resultado-mais-total do futebolmoneyline_3-way_+_total_goals do futebol (“Time A e Over N.5”) e 1st_half_moneyline_3-way_+_1st_half_total_goals e mercados análogos resultado-mais-total. Também team_total (“Time A Over N.5”), que carrega um time e uma direção, portanto nunca é um home/over simples.
Composto (time × BTTS)home_yes, home_no, away_yes, away_no, draw_yes, draw_nomatch_result_both_teams_to_score do futebol
Composto (dupla chance)home_draw, away_draw, home_awaydouble_chance do futebol (1X / X2 / 12), double_chance_reg_time do hóquei e dupla chance de MMA
Composto (round / método)home_r1, home_r2, home_decision, away_r1 etc.round_betting de MMA e mercados de método de vitória
Coringaothergame_prop, “sem gol” em next_goal, e qualquer seleção em que o mapeador de lado canônico não consegue decompor o resultado de forma limpa. Sempre presente em baixo volume; trate como opaco.

Parseando valores compostos. Strings compostas de selection_type sempre unem o eixo de time (home / away / draw) ao eixo secundário com um único underscore. Para recuperar apenas o eixo de time sem parsing, leia team_side — é o lado bruto carimbado pelo adaptador para a mesma linha.

Mercados de cauda longa emitem formas adicionais. Mercados como correct_score (ex.: "2_1"), 1st_set_correct_score (ex.: "6_4"), winning_margin, halftime_fulltime, first_goal e anytime_goal codificam resultados de placar ou compostos diretamente em selection_type. No tênis, correct_score é o placar da partida em sets ("2_1": o home_team da linha vence por dois sets a um), e o placar em games de um set fica em 1st_set_correct_score a 5th_set_correct_score. Se você depende de um enum fechado, filtre para as famílias acima e trate qualquer valor não reconhecido como opaco — não lance erro.

Tipos de mercado movidosLink permanente para esta seção

Em novembro de 2026 algumas casas moveram um mercado para o market_type que outras casas já usam para a mesma aposta. Só o market_type mudou: a aposta, suas seleções e seus preços são os mesmos. Filtre pelo id da coluna Agora.

ApostaCasasmarket_type anteriorAgoramarket= com o id anterior ainda as retorna
Futebol: resultado da partida e total de golsTodasmatch_result_total_goalsmoneyline_3-way_+_total_goalsCom sport=soccer
Futebol: resultado e gols do 1º tempoTodas1st_half_match_result_total_goals1st_half_moneyline_3-way_+_1st_half_total_goalsSim
Futebol: resultado de cada tempo (1X2)bovada1st_half_moneyline_3-way, 2nd_half_moneyline_3-way1st_half_moneyline, 2nd_half_moneylineCom sport=soccer
Futebol: total de pontos de cartõespinnacletotal_bookingstotal_card_pointsSim
Futebol: handicap de pontos de cartõespinnaclecards_handicapasian_handicap_card_pointsSim
Futebol: jogador marca ou dá assistênciabovadaplayer_to_score_or_assistplayer_goals_+_assistsSim
Esports: total de kills do time, por mapapinnacle1st_map_team_total a 5th_map_team_total1st_map_team_total_kills a 5th_map_team_total_killsSim
Basquete e futebol americano: empate anula aposta por tempohardrock, ballybet, stake1st_half_draw_no_bet, 2nd_half_draw_no_bet1st_half_moneyline, 2nd_half_moneylineCom sport=basketball ou sport=football
Primeira cesta, lances livres contamcaesars, stakefirst_basketfirst_basket_including_ftSim
Pontuação fantasyprizepicks, prizepicks_flexplayer_fantasy_score, 1st_half_player_fantasy_scoreplayer_fantasy_score_prizepicks_, 1st_half_player_fantasy_score_prizepicks_; no beisebol player_batting_fantasy_score_prizepicks_ (rebatedores), player_pitching_fantasy_score_prizepicks_ (arremessadores)Sim
Pontuação fantasyunderdog, underdog_multipliersplayer_fantasy_scoreplayer_fantasy_score_underdog_Sim
Hóquei: dupla chance, tempo regulamentarballybetdouble_chancedouble_chance_reg_timeCom sport=hockey
Hóquei: empate anula aposta, tempo regulamentarballybetdraw_no_betmoneyline_reg_timeCom sport=hockey
Hóquei: empate anula aposta, tempo regulamentarbetrivers, betparxdraw_no_bet_reg_timemoneyline_reg_timeCom sport=hockey
Hóquei: total do time, tempo regulamentarthescorebetteam_totalteam_total_reg_timeNão

Onde a última coluna diz sim, um filtro market= com o id anterior também retorna as linhas do id novo, incluindo casas que já publicavam o id novo antes da mudança. Onde diz não, o id anterior retorna só as casas que não mudaram.

Filtragem por Faixa de OddsLink permanente para esta seção

Use min_odds e max_odds para filtrar pelo valor das odds americanas.

# Retornar apenas odds positivas (+100 e acima) curl "https://api.sharpapi.io/api/v1/odds?league=nba&min_odds=100" \ -H "X-API-Key: YOUR_API_KEY" # Retornar apenas odds entre -200 e +200 curl "https://api.sharpapi.io/api/v1/odds?league=nba&min_odds=-200&max_odds=200" \ -H "X-API-Key: YOUR_API_KEY"

Resposta Agrupada por EventoLink permanente para esta seção

Use group_by=event para agrupar odds por evento em vez de uma lista plana. Isso é útil para construir UIs centradas em eventos.

curl "https://api.sharpapi.io/api/v1/odds?league=nba&group_by=event" \ -H "X-API-Key: YOUR_API_KEY"
{ "data": [ { "event_id": "33483153", "event_name": "PHI 76ers vs PHO Suns", "sport": "basketball", "league": "nba", "start_time": "2026-01-26T19:00:00Z", "is_live": false, "odds": [ { "id": "draftkings_33483153_moneyline_PHO", "sportsbook": "draftkings", "market_type": "moneyline", "selection": "PHO Suns", "selection_type": "away", "odds_american": -150, "odds_decimal": 1.667, "odds_probability": 0.60, "line": null, "timestamp": "2026-01-26T02:10:24.125Z", "price_updated_at": "2026-01-26T01:52:41.380Z" } ] } ], "meta": { "group_by": "event", "books_available": 5, "filters": { "league": "nba" }, "updated_at": "2026-01-26T02:10:37.846Z" } }

Acesso a Casas por TierLink permanente para esta seção

As casas de apostas incluídas em seus resultados de odds dependem do seu tier de assinatura:

TierCasas DisponíveisCasas de Apostas Incluídas
Free2DraftKings, FanDuel
Hobby5+ BetMGM, Caesars, theScore Bet
Pro15+ Bet365, BetRivers, e mais
Sharp25 (de 43)25 casas à sua escolha entre as 43 disponíveis
EnterpriseTodasTodas as casas de apostas disponíveis

Pinnacle (sharp book) requer tier Sharp ou superior. Solicitar sportsbook=pinnacle em um tier Free, Hobby ou Pro retornará um erro 403 tier_restricted.

Exemplos de FiltragemLink permanente para esta seção

# Obter odds ao vivo da NBA de todas as casas disponíveis curl "https://api.sharpapi.io/api/v1/odds?league=nba&is_live=true" \ -H "X-API-Key: YOUR_API_KEY" # Obter odds de moneyline e spread para um evento específico curl "https://api.sharpapi.io/api/v1/odds?event_id=nba_76ers_suns_2026-01-26_b3&market=moneyline,spread" \ -H "X-API-Key: YOUR_API_KEY" # Paginar por todas as odds de spread da NFL (use next_cursor de cada resposta) curl "https://api.sharpapi.io/api/v1/odds?league=nfl&market=spread&limit=200" \ -H "X-API-Key: YOUR_API_KEY"

Endpoints RelacionadosLink permanente para esta seção

  • Odds Delta - Obtenha apenas odds que mudaram desde um determinado timestamp
  • Best Odds - Obtenha as melhores odds em todas as casas para cada seleção
  • Odds Comparison - Compare odds entre casas lado a lado
  • Batch Odds - Busque odds para múltiplos eventos em uma única requisição
  • Markets - Liste tipos de mercado disponíveis
  • Sportsbooks - Liste casas de apostas disponíveis e seus status
Last updated on