Mercados
Obtenha os tipos de mercados disponíveis, suas configurações e disponibilidade por esporte.
GET /api/v1/marketsRequer 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âmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
sport | string | — | 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. |
league | string | — | 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_only | boolean | true | false 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. |
catalog | boolean | false | true 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
cURL
# 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
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Slug 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. |
name | string | Ró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_id | integer | Chave 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_count | integer | Nú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. |
sports | string[] | IDs de esportes que possuem este mercado atualmente (com sport=, apenas os esportes solicitados) |
sportsbooks | string[] | IDs de casas de apostas com pelo menos uma cotação atual neste mercado, dentro do escopo da requisição, ordenados. Nunca é null. |
coverage | object[] | Apenas com markets_only=false. Consulte coverage. |
priced | boolean | Apenas 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,sportsesportsbookssão[](nunca null) e, commarkets_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:
id | Antes | Agora |
|---|---|---|
defensive_poy | Defensive Poy | Defensive Player of the Year |
halftime_fulltime | Halftime Fulltime | Halftime / Fulltime |
1st_half_total_goals_odd_even | 1st Half Total Goals Odd Even | 1st Half Total Goals Odd/Even |
binary | Binary | Binary (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.
| Mercado | Descrição | Tem linha | Exemplos |
|---|---|---|---|
moneyline | Escolha o vencedor diretamente | Não | Lakers -150, Celtics +130 |
point_spread | Apostas com handicap de pontos | Sim | Lakers -4.5 (-110), Celtics +4.5 (-110) |
total_points | Over/Under da pontuação combinada | Sim | Over 220.5 (-110), Under 220.5 (-110) |
team_total | Aposta na pontuação de um time | Sim | Lakers 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.
| Mercado | Descrição | Tem linha | Exemplos |
|---|---|---|---|
player_prop | Estatísticas individuais de jogadores (pontos, rebotes, assistências, etc.) | Sim | LeBron James Over 25.5 Points |
game_prop | Resultados específicos do jogo (haverá prorrogação, etc.) | Não | First Team to Score |
Mercados de PeríodosLink permanente para esta seção
Mercados para períodos específicos dentro de um jogo (tempos, quartos).
| Mercado | Descrição | Tem linha |
|---|---|---|
1st_half | Moneyline, spread ou total do 1º tempo | Sim |
1st_quarter | Moneyline, spread ou total do 1º quarto | Sim |
Outros MercadosLink permanente para esta seção
| Mercado | Descrição | Tem linha | Exemplos |
|---|---|---|---|
future | Apostas de longo prazo em resultados de temporada ou campeonatos | Não | NBA Championship Winner, MVP Award Winner |
Tipos de SeleçãoLink permanente para esta seção
| Tipo | Usado Em | Descrição |
|---|---|---|
home | Moneyline, Spread, Período | Time da casa vence ou cobre |
away | Moneyline, Spread, Período | Time visitante vence ou cobre |
over | Total, Props, Período | Acima do valor da linha |
under | Total, Props, Período | Abaixo do valor da linha |
yes | Game Props, Team Props | O resultado ocorre |
no | Game Props, Team Props | O resultado não ocorre |
Disponibilidade de Mercados por EsporteLink permanente para esta seção
| Esporte | Moneyline | Spread | Total | Player Props | Team Props | Período |
|---|---|---|---|---|---|---|
| Basketball (NBA) | Sim | Sim | Sim | Sim | Sim | Sim |
| Football (NFL) | Sim | Sim | Sim | Sim | Sim | Sim |
| Baseball (MLB) | Sim | Sim | Sim | Sim | Sim | Sim |
| Hockey (NHL) | Sim | Sim | Sim | Sim | Sim | Sim |
| Basketball (NCAAB) | Sim | Sim | Sim | Limitado | Limitado | Sim |
| Football (NCAAF) | Sim | Sim | Sim | Limitado | Limitado | Sim |
| Soccer | Sim | Sim | Sim | Limitado | Limitado | Limitado |
| Tennis | Sim | Não | Sim | Limitado | Não | Não |
| MMA (UFC) | Sim | Não | Não | Limitado | Não | Não |
| Golf (PGA) | Sim | Não | Não | Limitado | Não | Nã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.5significa que o time precisa vencer por 7+) - Total: O limite da pontuação combinada (ex.:
215.5para over/under) - Player Props: O limite estatístico (ex.:
24.5pontos para um jogador) - Team Props: O limite estatístico do time (ex.:
105.5total 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
- Snapshot de Odds - Filtra odds por tipo de mercado
- Melhores Odds - Melhores odds filtradas por mercado
- Esportes - Veja quais esportes estão disponíveis
- Casas de Apostas - Veja quais casas suportam quais mercados