Skip to Content

Mercados

Obtenha os tipos de mercados disponíveis, suas configurações e disponibilidade por esporte.

GET /api/v1/markets

Requer uma API key. Disponível em todos os planos (Free incluído). Requisições não autenticadas retornam 401.

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

Todos os parâmetros são opcionais. Sem nenhum, a resposta lista cada mercado que tem uma cotação atual. catalog=true lista cada mercado, cotado ou não.

ParâmetroTipoPadrãoDescrição
sportstring—Apenas mercados com cotação nesses esportes; vários separados por vírgula (basketball,hockey). event_count, sportsbooks e sports passam a cobrir apenas os esportes solicitados.
leaguestring—Apenas mercados com cotação nessas ligas; várias separadas por vírgula. Use o id de Ligas. Um evento compartilhado por duas ligas solicitadas conta uma vez.
markets_onlybooleantruefalse adiciona coverage a cada linha: as casas de apostas que cotam o mercado em cada esporte e liga. Um valor que não é booleano retorna 400 com o código validation_error.
catalogbooleanfalsetrue lista cada mercado da lista de mercados, cotado ou não, e adiciona priced a cada linha. Consulte Visão de catálogo. Um valor que não é booleano retorna 400 com o código validation_error.

Vários valores em sport ou league retornam a união, e com os dois parâmetros um mercado precisa atender a ambos. Uma resposta filtrada repete os sport e league aplicados. Um valor sem cotações ao vivo no momento (ou que não publicamos) não é um erro: a resposta traz as linhas dos demais valores, ou data: [], mais um filter_warning que o identifica:

{ "data": [], "filter_warning": { "code": "unknown_league", "message": "no odds are live for these leagues right now, or the ids are not ones we publish; see GET /api/v1/leagues for the current list", "unknown_leagues": ["xyz"] }, "league": "xyz", "updated_at": "2026-11-09T16:40:45.488543236Z" }

Para um esporte, o código é unknown_sport e a lista é unknown_sports.

Exemplos de RequisiçõesLink permanente para esta seção

# List all markets curl -X GET "https://api.sharpapi.io/api/v1/markets" \ -H "X-API-Key: YOUR_API_KEY" # Apenas mercados da NBA, com as casas de apostas de cada liga curl -X GET "https://api.sharpapi.io/api/v1/markets?league=nba&markets_only=false" \ -H "X-API-Key: YOUR_API_KEY" # Cada mercado, cotado ou não curl -X GET "https://api.sharpapi.io/api/v1/markets?catalog=true" \ -H "X-API-Key: YOUR_API_KEY"

RespostaLink permanente para esta seção

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

Resposta real, truncada para dois dos tipos de mercado retornados atualmente (ordenados por event_count em ordem decrescente):

{ "data": [ { "id": "moneyline", "name": "Moneyline", "numerical_id": 878, "event_count": 6910, "sports": ["aussie_rules", "badminton", "baseball", "basketball", "boxing", "cricket", "darts", "esports", "floorball", "football", "golf", "handball", "hockey", "mma", "rugby_league", "rugby_union", "snooker", "soccer", "table_tennis", "tennis", "volleyball"], "sportsbooks": ["ballybet", "bet365", "betfair", "betfair_lay", "betfred", "betmgm", "betonline", "betparx", "betrivers", "betsson", "betvictor", "betway", "bovada", "bwin", "caesars", "circa", "codere", "coral", "draftkings", "eighteenbet", "fanatics", "fanatics_markets", "fanduel", "fliff", "gemini", "ggbet", "goldrush", "hardrock", "kalshi", "ladbrokes", "ladbrokes_uk", "matchbook", "novig", "onexbet", "paddypower", "pinnacle", "polymarket", "prophetx", "rebet", "robinhood", "saba", "sbobet", "skybet", "smarkets", "sport888_it", "sportzino", "stake", "sx_bet", "thescorebet", "thrillzz", "unibet"] }, { "id": "2nd_half_team_total", "name": "2nd Half Team Total", "numerical_id": 331, "event_count": 42, "sports": ["basketball", "football"], "sportsbooks": ["draftkings", "fanduel", "hardrock"] } ], "updated_at": "2026-11-09T16:44:28.388212051Z" }

Esquema do Objeto MarketLink permanente para esta seção

CampoTipoDescrição
idstringSlug do mercado — exatamente o valor que os endpoints de cotações aceitam como market_type= (ou seu alias market=). Consulte a seção sobre uso de mercados em filtros abaixo.
namestringRótulo legível, apenas para exibição: o rótulo da lista de mercados ou, para um mercado que a lista ainda não tem, um nome construído a partir de id. Consulte Nomes. Não é um valor de filtro — use id no lugar.
numerical_idintegerChave inteira estável (congelada, nunca reutilizada; omitida quando não mapeada). Novo (maio de 2026) — aditivo, opcional. Consulte IDs de referência de entidade.
event_countintegerNúmero de eventos distintos com pelo menos uma cotação atual neste mercado, somando todas as casas de apostas, dentro do escopo sport / league da requisição. Um evento conta uma vez, não importa quantas casas, linhas e seleções o cotem.
sportsstring[]IDs de esportes que possuem este mercado atualmente (com sport=, apenas os esportes solicitados)
sportsbooksstring[]IDs de casas de apostas com pelo menos uma cotação atual neste mercado, dentro do escopo da requisição, ordenados. Nunca é null.
coverageobject[]Apenas com markets_only=false. Consulte coverage.
pricedbooleanApenas com catalog=true. true quando pelo menos uma casa de apostas tem uma cotação atual neste mercado dentro do escopo da requisição. Consulte Visão de catálogo.

coverageLink permanente para esta seção

Com markets_only=false, cada linha traz também coverage: os esportes em que o mercado tem cotação, as ligas de cada esporte e as casas de apostas que o cotam em cada liga. Esportes e ligas são ordenados por id, e o id de uma liga é o que Ligas retorna. Em uma requisição filtrada, coverage contém apenas os esportes e ligas solicitados. Linha real de ?markets_only=false:

{ "id": "2nd_half_team_total", "name": "2nd Half Team Total", "numerical_id": 331, "event_count": 42, "sports": ["basketball", "football"], "sportsbooks": ["draftkings", "fanduel", "hardrock"], "coverage": [ { "id": "basketball", "leagues": [ { "id": "nba", "sportsbooks": ["draftkings"] }, { "id": "ncaab", "sportsbooks": ["fanduel"] } ] }, { "id": "football", "leagues": [ { "id": "nfl", "sportsbooks": ["draftkings", "fanduel", "hardrock"] } ] } ] }

Uma cotação em um evento cuja liga não conseguimos identificar ainda adiciona sua casa de apostas a sportsbooks da linha, mas não aparece sob nenhuma liga em coverage. Assim, uma casa pode estar em sportsbooks sem aparecer em nenhuma liga, e coverage é [] (nunca null) para um mercado cotado apenas nesses eventos.

Visão de catálogo (catalog=true)Link permanente para esta seção

Sem catalog, a resposta lista apenas os mercados com uma cotação atual, então falta um mercado que nenhuma casa de apostas cota agora. catalog=true lista cada mercado da lista de mercados, cotado ou não: 1.532 linhas em 2026-11-11, contra 673 sem o parâmetro. Cada linha passa a trazer priced:

  • priced: true: pelo menos uma casa de apostas tem uma cotação atual no mercado. A linha é a mesma que sem o parâmetro.
  • priced: false: nenhuma casa de apostas cota o mercado agora. event_count é 0, sports e sportsbooks são [] (nunca null) e, com markets_only=false, coverage é [].

Um mercado cotado que a lista de mercados ainda não tem também é retornado, com priced: true e sem numerical_id, então a visão de catálogo sempre contém cada linha da resposta sem o parâmetro. As linhas mantêm a ordem habitual, event_count em ordem decrescente, então os mercados sem cotação vêm por último, ordenados por id. Linha real sem cotação de ?catalog=true:

{ "id": "4th_map_team_total_kills", "name": "4th Map Team Total Kills", "numerical_id": 601, "event_count": 0, "sports": [], "sportsbooks": [], "priced": false }

A lista de mercados não diz a quais esportes ou ligas um mercado pertence. Por isso, com sport ou league, catalog=true retorna apenas as linhas cotadas desse escopo (as mesmas linhas que sem o parâmetro, cada uma com priced: true) e deixa de fora os mercados sem cotação. Sem o parâmetro, ou com catalog=false, a resposta lista apenas os mercados cotados, como antes, e suas linhas não trazem o campo priced.

Alterado (novembro de 2026): os nomes vêm da lista de mercadosLink permanente para esta seção

Desde 2026-11-11, o name de um mercado é o rótulo que a lista de mercados dá a ele. Antes, a maioria dos nomes era construída a partir do id, com cada palavra em maiúscula inicial. 93 dos mercados cotados naquele dia mudaram de nome uma vez; id, numerical_id e todas as contagens não mudam. Exemplos:

idAntesAgora
defensive_poyDefensive PoyDefensive Player of the Year
halftime_fulltimeHalftime FulltimeHalftime / Fulltime
1st_half_total_goals_odd_even1st Half Total Goals Odd Even1st Half Total Goals Odd/Even
binaryBinaryBinary (Prediction Market)

Um mercado que a lista ainda não tem mantém o nome construído a partir do seu id. Mercados de Eventos e Odds em Lote enviam o mesmo nome como market_label, então um mercado tem um só nome em cada endpoint. Se você identifica mercados por name, use id no lugar.

Alterado (novembro de 2026): event_count conta eventosLink permanente para esta seção

Antes de 2026-11-09, event_count contava cotações (cada linha e seleção em cada casa de apostas), não eventos. Agora cada evento conta uma vez, então os valores caíram bastante: no catálogo completo, point_spread passou de cerca de 110.000 para cerca de 3.100. Se você ordena ou filtra mercados por event_count, revise seus limites. A mesma mudança adicionou sportsbooks e markets_only=false.

Tipos de MercadosLink permanente para esta seção

As tabelas abaixo são uma referência descritiva de mercados. A coluna Tem linha descreve o tipo de mercado e não é um campo na resposta de /markets (os campos da resposta estão listados na tabela do esquema acima).

Mercados PrincipaisLink permanente para esta seção

Os mercados de apostas mais populares e amplamente disponíveis.

MercadoDescriçãoTem linhaExemplos
moneylineEscolha o vencedor diretamenteNãoLakers -150, Celtics +130
point_spreadApostas com handicap de pontosSimLakers -4.5 (-110), Celtics +4.5 (-110)
total_pointsOver/Under da pontuação combinadaSimOver 220.5 (-110), Under 220.5 (-110)
team_totalAposta na pontuação de um timeSimLakers Over 112.5, Lakers Under 112.5

Mercados de PropsLink permanente para esta seção

Apostas proposicionais sobre jogadores e jogos para resultados mais específicos.

MercadoDescriçãoTem linhaExemplos
player_propEstatísticas individuais de jogadores (pontos, rebotes, assistências, etc.)SimLeBron James Over 25.5 Points
game_propResultados específicos do jogo (haverá prorrogação, etc.)NãoFirst Team to Score

Mercados de PeríodosLink permanente para esta seção

Mercados para períodos específicos dentro de um jogo (tempos, quartos).

MercadoDescriçãoTem linha
1st_halfMoneyline, spread ou total do 1º tempoSim
1st_quarterMoneyline, spread ou total do 1º quartoSim

Outros MercadosLink permanente para esta seção

MercadoDescriçãoTem linhaExemplos
futureApostas de longo prazo em resultados de temporada ou campeonatosNãoNBA Championship Winner, MVP Award Winner

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

TipoUsado EmDescrição
homeMoneyline, Spread, PeríodoTime da casa vence ou cobre
awayMoneyline, Spread, PeríodoTime visitante vence ou cobre
overTotal, Props, PeríodoAcima do valor da linha
underTotal, Props, PeríodoAbaixo do valor da linha
yesGame Props, Team PropsO resultado ocorre
noGame Props, Team PropsO resultado não ocorre

Disponibilidade de Mercados por EsporteLink permanente para esta seção

EsporteMoneylineSpreadTotalPlayer PropsTeam PropsPeríodo
Basketball (NBA)SimSimSimSimSimSim
Football (NFL)SimSimSimSimSimSim
Baseball (MLB)SimSimSimSimSimSim
Hockey (NHL)SimSimSimSimSimSim
Basketball (NCAAB)SimSimSimLimitadoLimitadoSim
Football (NCAAF)SimSimSimLimitadoLimitadoSim
SoccerSimSimSimLimitadoLimitadoLimitado
TennisSimNãoSimLimitadoNãoNão
MMA (UFC)SimNãoNãoLimitadoNãoNão
Golf (PGA)SimNãoNãoLimitadoNãoNão

“Limitado” significa que o mercado está disponível para alguns eventos, mas não todos, dependendo da casa de apostas e do evento. Use os endpoints de odds para ver quais mercados estão disponíveis para um evento específico.

Usando Mercados em FiltrosLink permanente para esta seção

Use o id do mercado como parâmetro de filtro em outros endpoints. Os endpoints de cotações o aceitam como market_type= ou, de forma equivalente, como market=. O campo name é um rótulo de exibição e não um valor de filtro.

# Get only moneyline odds curl "https://api.sharpapi.io/api/v1/odds?market=moneyline" \ -H "X-API-Key: YOUR_API_KEY" # Get spread and total odds curl "https://api.sharpapi.io/api/v1/odds?market=point_spread,total_points" \ -H "X-API-Key: YOUR_API_KEY" # Get player props only curl "https://api.sharpapi.io/api/v1/odds?market=player_prop" \ -H "X-API-Key: YOUR_API_KEY" # Best odds for moneyline markets curl "https://api.sharpapi.io/api/v1/odds/best?market=moneyline" \ -H "X-API-Key: YOUR_API_KEY"

Exemplo prático: de uma linha de /markets a uma consulta de cotaçõesLink permanente para esta seção

Nas props é onde o nome de exibição e o slug mais diferem, então é aí que o mapeamento importa. Veja esta linha da resposta de /markets (outros campos omitidos):

{ "id": "player_longest_reception", "name": "Player Longest Reception", "sports": ["football"] }

Passe o id — player_longest_reception — e não o name:

curl "https://api.sharpapi.io/api/v1/odds?market_type=player_longest_reception&league=nfl" \ -H "X-API-Key: YOUR_API_KEY"

Cada linha retornada repete o mesmo slug em seu próprio campo market_type, então você sempre consegue voltar de um resultado para a entrada correspondente em /markets.

Entendendo as LinhasLink permanente para esta seção

Mercados que têm linha incluem um valor numérico de line na resposta de odds:

  • Spread: O handicap de pontos (ex.: -6.5 significa que o time precisa vencer por 7+)
  • Total: O limite da pontuação combinada (ex.: 215.5 para over/under)
  • Player Props: O limite estatístico (ex.: 24.5 pontos para um jogador)
  • Team Props: O limite estatístico do time (ex.: 105.5 total de pontos do time)

Mercados sem linha (como moneyline) têm line: null na resposta de odds. O catálogo /markets não informa de que tipo é cada mercado; leia line nas próprias linhas de odds.

Endpoints RelacionadosLink permanente para esta seção

Last updated on