Endpoints Enterprise
Endpoints avançados disponíveis exclusivamente para assinantes do plano Enterprise.
Todos os endpoints desta página exigem uma assinatura Enterprise. Planos inferiores receberão um erro 403 tier_restricted.
FuturesLink permanente para esta seção
Futures são mercados de temporada: campeão, vencedor de conferência e de divisão, MVP e outros prêmios, totais de vitórias, classificação aos playoffs. Dois endpoints os servem:
| Endpoint | Retorna |
|---|---|
GET /api/v1/futures | Os futures: cada um com seu id, seu nome e as casas de apostas que o precificam |
GET /api/v1/futures/odds | Os futures com suas odds: um registro por casa de apostas, seleção, lado e linha |
Liste os futures para encontrar o id que você quer e passe-o como future_id ao endpoint de odds.
Futures canônicosLink permanente para esta seção
As casas de apostas nomeiam o mesmo mercado, e o mesmo time ou jogador, de formas diferentes. A SharpAPI coloca a versão de cada casa de apostas de um future em um único future com um único id e um único nome, e cada versão de um time ou jogador em uma única seleção com um único nome. Assim, os preços de um future se comparam registro a registro entre as casas de apostas.
- Id. O id da liga, dois underscores e o nome em snake case minúsculo:
nfl__super_bowl_winner,nba__regular_season_wins,england_-_premier_league__championship_winner. Pegue os ids do catálogo em vez de montá-los: um nome que carrega um ano (1st Overall Pick 2027) muda de id quando o ano muda. - Nome. Um nome por future, em um estilo fixo:
Super Bowl Winner,AFC South Winner,MVP Winner,Regular Season Wins. - Seleção. O time ou jogador a que um preço se refere, sob seu único nome canônico:
San Francisco 49erse, no futebol, o nome completo do clube,Arsenal FC.normalized_selectioné esse nome em uma forma própria para cruzar dados. - Lado e linha. Um registro fixa o preço de um lado de uma seleção:
overouunderem uma linha de uma escada de vitórias,yesouno, ou nenhum lado em um outright. - Tipo de future.
TEAMquando as seleções são times,PLAYERquando são jogadores,UNKNOWNquando não são nem uma coisa nem outra (um técnico, uma divisão, um estado).
Formatos de registroLink permanente para esta seção
| Formato | selection | selection_line | points | Future de exemplo |
|---|---|---|---|---|
| Outright | O time, jogador ou outro sujeito: Kansas City Chiefs | null | null | nfl__super_bowl_winner |
| Escada | O time: Buffalo Bills | over ou under | A linha: 12.5 | nfl__regular_season_wins |
| Yes/No | O sujeito: Buffalo Bills | yes ou no | null | nfl__to_make_the_playoffs |
| Par | Dois sujeitos unidos por ///: Arizona Cardinals /// Baltimore Ravens | null | null | nfl__super_bowl_matchup |
Um par mantém a ordem de seus dois nomes em uma exacta (nfl__super_bowl_exacta) e os lista em ordem alfabética em um confronto (matchup).
Gêmeos Yes/NoLink permanente para esta seção
Muitos outrights têm um future gêmeo, com o id <id>_yes_no e o nome <Name> Yes/No: nfl__super_bowl_winner e nfl__super_bowl_winner_yes_no. O outright contém cada preço sobre um sujeito, sem lado. O gêmeo repete cada um desses preços como um registro yes e acrescenta o preço da casa de apostas contra o sujeito, quando ela o lista, como um registro no. Um registro no nunca aparece no outright. Um gêmeo contém apenas registros yes quando nenhuma casa de apostas lista um preço contra. Nem todo outright tem gêmeo: nba__championship_winner não tem.
O preço da BetMGM nos Kansas City Chiefs, no outright e em seu gêmeo:
| Future | name | selection_line | price |
|---|---|---|---|
nfl__super_bowl_winner | Kansas City Chiefs | null | 900 |
nfl__super_bowl_winner_yes_no | Kansas City Chiefs Yes | yes | 900 |
O que não é servidoLink permanente para esta seção
A oferta de uma casa de apostas que não se encaixa em nenhum future não é servida: especiais semanais, props de um único jogo, price boosts e mercados de novidade. Uma casa de apostas tem no máximo um registro por seleção, lado e linha em um future.
GET /api/v1/futuresLink permanente para esta seção
Liste os futures: cada future com as casas de apostas que o precificam e quanto está precificado.
GET /api/v1/futuresParâmetros de ConsultaLink permanente para esta seção
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
sport | string | all | Filtrar por esporte: um valor, sem diferenciar maiúsculas de minúsculas (football, basketball, soccer) |
league | string | all | Filtrar por liga: um valor, sem diferenciar maiúsculas de minúsculas, como /leagues a lista (nfl, nba, england_-_premier_league) |
future_type | string | all | TEAM, PLAYER ou UNKNOWN, sem diferenciar maiúsculas de minúsculas. Qualquer outro valor retorna um data vazio. |
future_id | string | all | Um id de future, ou vários separados por vírgula |
Todo future que corresponde é retornado: não há paginação, e sportsbook, limit e offset são ignorados se enviados.
Exemplo de RequisiçãoLink permanente para esta seção
curl "https://api.sharpapi.io/api/v1/futures?league=nfl" \
-H "X-API-Key: YOUR_API_KEY"RespostaLink permanente para esta seção
Abreviada para três futures. meta.count é o número de futures da resposta completa.
{
"success": true,
"data": [
{
"id": "nfl__1st_overall_pick_2027",
"name": "1st Overall Pick 2027",
"future_type": "PLAYER",
"sport": "football",
"league": "nfl",
"start_date": "2026-11-07T17:05:00Z",
"books_available": [
"betmgm",
"betonline",
"bwin",
"fanduel"
],
"selection_count": 88,
"odds_count": 198
},
{
"id": "nfl__afc_conference_winner",
"name": "AFC Conference Winner",
"future_type": "TEAM",
"sport": "football",
"league": "nfl",
"start_date": "2026-11-06T01:15:00Z",
"books_available": [
"betonline",
"saba"
],
"selection_count": 16,
"odds_count": 32
},
{
"id": "nfl__afc_conference_winner_yes_no",
"name": "AFC Conference Winner Yes/No",
"future_type": "TEAM",
"sport": "football",
"league": "nfl",
"start_date": "2026-11-06T01:15:00Z",
"books_available": [
"betonline",
"saba"
],
"selection_count": 16,
"odds_count": 32
}
],
"meta": {
"count": 47,
"updated_at": "2026-10-26T12:39:49.784599258Z"
}
}Os futures são ordenados por league e depois por id. meta.updated_at indica quando os dados de futures desta resposta foram lidos (RFC 3339), não quando a resposta foi enviada. Requisições consecutivas podem retornar o mesmo valor.
Objeto FutureLink permanente para esta seção
| Campo | Tipo | Descrição |
|---|---|---|
id | string | O id do future (nfl__super_bowl_winner). Passe-o como future_id para /futures/odds. |
name | string | O nome do future (Super Bowl Winner). Um gêmeo Yes/No termina em Yes/No. |
future_type | string | TEAM, PLAYER ou UNKNOWN |
sport | string | Esporte (football) |
league | string | Id da liga (nfl) |
start_date | string | null | O início mais cedo que alguma casa de apostas envia para este future, em UTC (2027-06-01T19:00:00Z), ou null quando nenhuma envia um. As casas datam um mercado de futures pelo seu fechamento ou pelo começo do seu evento, então podem divergir; o mais cedo é mostrado, mesmo depois de passado. Para a data própria de uma casa, consulte /futures/odds só para essa casa. |
books_available | array of string | As casas de apostas que precificam este future, ordenadas por nome |
selection_count | integer | Seleções distintas do future |
odds_count | integer | Registros do future: cada casa de apostas, seleção, lado e linha |
GET /api/v1/futures/oddsLink permanente para esta seção
Obtenha os futures com suas odds. Cada future traz um registro por casa de apostas, seleção, lado e linha.
GET /api/v1/futures/oddsParâmetros de ConsultaLink permanente para esta seção
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
future_id | string | - | Um id de future, ou vários separados por vírgula. Obrigatório, a menos que league seja informado. |
league | string | - | Todos os futures de uma liga: sem diferenciar maiúsculas de minúsculas, como /leagues a lista (nfl). Obrigatório, a menos que future_id seja informado. |
sport | string | all | Filtrar por esporte: um valor, sem diferenciar maiúsculas de minúsculas |
future_type | string | all | TEAM, PLAYER ou UNKNOWN, sem diferenciar maiúsculas de minúsculas. Qualquer outro valor retorna um data vazio. |
sportsbook | string | all | Apenas registros destas casas de apostas, separadas por vírgula (fanduel,betmgm). books é aceito como alias. |
team_id | string | all | Apenas registros destes times, ids de time separados por vírgula (kansas_city_chiefs). Um registro cujo team_id é null nunca corresponde. |
selection | string | all | Apenas registros destas seleções, nomes separados por vírgula (Boston Celtics). Maiúsculas, acentos e pontuação são ignorados, então CJ Stroud encontra C.J. Stroud. Um valor de normalized_selection também corresponde. |
is_main | boolean | - | true: a linha principal de cada escada e todo registro que não é de uma escada. false: apenas as outras linhas de uma escada. Qualquer outro valor é ignorado. |
limit | integer | 50 | Futures por página, de 1 a 200. Um valor fora dessa faixa (0, negativo, acima de 200, não numérico) passa a ser 50. |
offset | integer | 0 | Futures a pular. Um valor negativo ou não numérico passa a ser 0. |
Passe future_id ou league. Uma requisição sem nenhum dos dois retorna 400 validation_error, de modo que nenhuma requisição pede todos os registros de todas as ligas. Alguns futures contêm centenas de registros (uma exacta do Super Bowl lista centenas de pares de times): restrinja com sportsbook, team_id, selection ou is_main.
Exemplos de RequisiçõesLink permanente para esta seção
# O preço de um time em um outright, em cada casa de apostas
curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__super_bowl_winner&team_id=kansas_city_chiefs" \
-H "X-API-Key: YOUR_API_KEY"
# A escada de vitórias de um time
curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nba__regular_season_wins&selection=Boston+Celtics" \
-H "X-API-Key: YOUR_API_KEY"
# Apenas a linha principal de vitórias de cada casa de apostas, para todos os times da NFL
curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__regular_season_wins&is_main=true" \
-H "X-API-Key: YOUR_API_KEY"
# Todos os futures da NBA de uma casa de apostas, dois futures por página, segunda página
curl "https://api.sharpapi.io/api/v1/futures/odds?league=nba&sportsbook=fanduel&limit=2&offset=2" \
-H "X-API-Key: YOUR_API_KEY"RespostaLink permanente para esta seção
Resposta à primeira requisição. Abreviada para dois de seus seis registros; meta.odds_count é o número de registros da resposta completa.
{
"success": true,
"data": [
{
"id": "nfl__super_bowl_winner",
"name": "Super Bowl Winner",
"future_type": "TEAM",
"sport": "football",
"league": "nfl",
"start_date": "2026-09-10T00:20:00Z",
"odds": [
{
"id": "nfl__super_bowl_winner:betmgm:kansas_city_chiefs",
"sportsbook": "betmgm",
"market": "Super Bowl Winner",
"name": "Kansas City Chiefs",
"selection": "Kansas City Chiefs",
"normalized_selection": "kansas_city_chiefs",
"selection_line": null,
"points": null,
"is_main": true,
"price": 900,
"team_id": "kansas_city_chiefs"
},
{
"id": "nfl__super_bowl_winner:betonline:kansas_city_chiefs",
"sportsbook": "betonline",
"market": "Super Bowl Winner",
"name": "Kansas City Chiefs",
"selection": "Kansas City Chiefs",
"normalized_selection": "kansas_city_chiefs",
"selection_line": null,
"points": null,
"is_main": true,
"price": 850,
"team_id": "kansas_city_chiefs"
}
]
}
],
"pagination": {
"limit": 50,
"offset": 0,
"count": 1,
"total": 1,
"has_more": false,
"next_offset": null
},
"meta": {
"count": 1,
"total": 1,
"odds_count": 6,
"updated_at": "2026-10-26T12:39:49.784599258Z"
}
}Resposta à segunda requisição, uma escada. Abreviada para quatro de seus dez registros: a BetMGM precifica uma linha, 51.5, nos dois lados, e a FanDuel lista apenas overs, em seis linhas.
{
"success": true,
"data": [
{
"id": "nba__regular_season_wins",
"name": "Regular Season Wins",
"future_type": "TEAM",
"sport": "basketball",
"league": "nba",
"start_date": "2027-06-19T00:40:00Z",
"odds": [
{
"id": "nba__regular_season_wins:betmgm:boston_celtics:over:51.5",
"sportsbook": "betmgm",
"market": "Regular Season Wins",
"name": "Boston Celtics Over 51.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "over",
"points": 51.5,
"is_main": true,
"price": -145,
"team_id": "boston_celtics"
},
{
"id": "nba__regular_season_wins:betmgm:boston_celtics:under:51.5",
"sportsbook": "betmgm",
"market": "Regular Season Wins",
"name": "Boston Celtics Under 51.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "under",
"points": 51.5,
"is_main": true,
"price": 120,
"team_id": "boston_celtics"
},
{
"id": "nba__regular_season_wins:fanduel:boston_celtics:over:49.5",
"sportsbook": "fanduel",
"market": "Regular Season Wins",
"name": "Boston Celtics Over 49.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "over",
"points": 49.5,
"is_main": false,
"price": -220,
"team_id": "boston_celtics"
},
{
"id": "nba__regular_season_wins:fanduel:boston_celtics:over:54.5",
"sportsbook": "fanduel",
"market": "Regular Season Wins",
"name": "Boston Celtics Over 54.5",
"selection": "Boston Celtics",
"normalized_selection": "boston_celtics",
"selection_line": "over",
"points": 54.5,
"is_main": true,
"price": 130,
"team_id": "boston_celtics"
}
]
}
],
"pagination": {
"limit": 50,
"offset": 0,
"count": 1,
"total": 1,
"has_more": false,
"next_offset": null
},
"meta": {
"count": 1,
"total": 1,
"odds_count": 10,
"updated_at": "2026-10-26T12:41:24.754966665Z"
}
}Objeto de registroLink permanente para esta seção
Cada future em data traz os id, name, future_type, sport e league que /futures lista, um start_date e um array odds com os registros. Um future ao qual não sobra nenhum registro após os filtros é omitido.
Aqui start_date é o início mais cedo entre as casas de apostas que a requisição informa em sportsbook (todas, quando não informa nenhuma), ou null quando nenhuma delas envia um; uma requisição para uma única casa traz a data própria dessa casa. team_id, selection e is_main filtram registros e não mudam start_date.
| Campo | Tipo | Descrição |
|---|---|---|
id | string | O id do registro: o id do future, a casa de apostas e a normalized_selection, depois o lado e os pontos quando o registro os tem, unidos por : (nfl__regular_season_wins:betmgm:buffalo_bills:over:12.5). Não muda quando o preço muda. |
sportsbook | string | Id da casa de apostas (betmgm) |
market | string | O name do future, repetido em cada registro |
name | string | Um rótulo para exibição: a seleção, depois o lado com inicial maiúscula e depois os pontos (Kansas City Chiefs, Kansas City Chiefs Yes, Buffalo Bills Over 12.5) |
selection | string | O nome canônico do time ou jogador, igual em todas as casas de apostas (San Francisco 49ers). Um par é formado por dois nomes unidos por ///. |
normalized_selection | string | selection em minúsculas, com cada sequência de caracteres diferentes de a-z, dígitos e - substituída por um único _: C.J. Stroud vira c_j_stroud e Jaren Jackson Jr. vira jaren_jackson_jr_. Use-a para cruzar registros entre casas de apostas. |
selection_line | string | null | over ou under em uma escada, yes ou no em um future Yes/No, null em um outright ou em um par |
points | number | null | A linha de uma escada (12.5). null em todo registro cujo selection_line não é over nem under. |
is_main | boolean | true na linha principal de uma casa de apostas em uma escada, false nas outras linhas dela. Sempre true em um registro que não é de uma escada. Veja abaixo. |
price | integer | Odds americanas: 900 é +900, -130 é -130. Derive dela as odds decimais e a probabilidade implícita: veja Formatos de Odds. |
team_id | string | null | O id do time, o mesmo id que os endpoints de odds usam para times (IDs de referência de entidade), quando a seleção é um time. null caso contrário: um jogador, um par, um técnico, uma divisão, um estado ou um time que a SharpAPI não consegue identificar. Nem sempre é igual a normalized_selection: Arsenal FC é arsenal. |
Linhas principaisLink permanente para esta seção
Uma casa de apostas pode listar várias linhas de uma escada para a mesma seleção. is_main é true em exatamente uma linha por casa de apostas e seleção: a linha que a casa de apostas precifica nos dois lados e cujos dois preços estão mais próximos de uma odd par (even). Quando ela não precifica nenhuma linha nos dois lados, como a FanDuel faz acima, é a linha cujo preço está mais próximo de uma odd par, aqui 54.5 a +130. Uma linha precificada nos dois lados sempre vence uma linha precificada em apenas um lado, e em caso de empate vence a linha mais baixa. is_main=true mantém essas linhas (e todo registro que não é de uma escada); is_main=false mantém as demais.
Ordenação e paginaçãoLink permanente para esta seção
Os futures são ordenados por league e depois por id. Os registros dentro de um future são ordenados por normalized_selection, depois por sportsbook, depois por lado (sem lado, over, under, yes, no) e depois por points. Os registros não são ordenados por preço: ordene no cliente.
limit e offset contam futures, não registros. Uma página contém até limit futures, cada um com todos os seus registros que correspondem aos filtros.
| Campo | Tipo | Descrição |
|---|---|---|
pagination.limit | integer | Futures por página, conforme aplicado |
pagination.offset | integer | Futures pulados antes desta página |
pagination.count | integer | Futures desta página. Igual a meta.count. |
pagination.total | integer | Futures que correspondem aos filtros, antes de paginar. Igual a meta.total. |
pagination.has_more | boolean | Se há outra página a seguir |
pagination.next_offset | integer | null | O offset da próxima página, ou null na última página |
meta.count | integer | Futures em data |
meta.total | integer | Futures que correspondem aos filtros, antes de paginar |
meta.odds_count | integer | Registros em data, entre todos os seus futures |
meta.updated_at | string | Quando os dados de futures desta resposta foram lidos (RFC 3339), não quando a resposta foi enviada. Requisições consecutivas podem retornar o mesmo valor. |
O envelope da quarta requisição, a segunda página de futures da NBA com dois por página. 19 futures correspondem; os dois desta página contêm 13 e 15 registros, então meta.odds_count é 28.
{
"success": true,
"data": [ ... ],
"pagination": {
"limit": 2,
"offset": 2,
"count": 2,
"total": 19,
"has_more": true,
"next_offset": 4
},
"meta": {
"count": 2,
"total": 19,
"odds_count": 28,
"updated_at": "2026-10-26T12:41:24.754966665Z"
}
}ErrosLink permanente para esta seção
| Status | Código | Quando |
|---|---|---|
400 | validation_error | /futures/odds foi chamado sem future_id e sem league |
401 | missing_api_key, invalid_api_key | Sem API key, ou uma inválida |
403 | tier_restricted | O plano da chave é inferior a Enterprise |
429 | rate_limited | Limite de taxa excedido |
503 | service_unavailable | Os dados de futures estão temporariamente indisponíveis: não foi possível ler uma cópia com menos de 5 minutos. Tente novamente mais tarde; o header Retry-After informa os segundos de espera. |
{
"error": {
"code": "validation_error",
"message": "Missing required parameter: future_id or league"
}
}Um filtro que não corresponde a nenhum future não é um erro: a resposta é 200 com um data vazio.
Migração da forma de resposta anteriorLink permanente para esta seção
Os dois endpoints mantêm seus caminhos e retornam a forma descrita acima. A forma anterior não é mais servida, e nenhum parâmetro a traz de volta.
Um future_id da forma anterior (championship_winner) não corresponde mais a nada: a resposta é 200 com um data vazio. Pegue os novos ids em GET /api/v1/futures. future_type=OVER_UNDER e future_type=YES_NO também retornam um data vazio: os tipos de future são TEAM, PLAYER e UNKNOWN, e o lado de um registro é o seu selection_line.
GET /api/v1/futures
| Antes | Agora |
|---|---|
market_id (championship_winner) | id (nba__championship_winner): os valores mudaram |
display_name (NBA Championship Winner) | name (Championship Winner) |
future_type: TEAM, PLAYER, OVER_UNDER, YES_NO | future_type: TEAM, PLAYER, UNKNOWN |
sport, league, selection_count, books_available | Mantidos |
| - | odds_count |
| - | start_date |
| - | Parâmetro de consulta future_id |
GET /api/v1/futures/odds
| Antes | Agora |
|---|---|
| Uma lista plana de registros, paginada por registro, 100 registros por padrão | Uma lista de futures, cada um com um array odds, paginada por future, 50 futures por padrão |
future_id obrigatório | future_id ou league obrigatório |
selection | selection, e normalized_selection para cruzar dados |
sportsbook | sportsbook |
odds_american | price |
odds_decimal, probability | Removidos: derive-os de price |
line | points, com o lado em selection_line (over, under, yes, no) |
future_market_id, future_market_name, future_type, sport, league em cada registro | id, name, future_type, sport, league no future que contém os registros |
event_start_time em cada registro | start_date no future que contém os registros: o início mais cedo entre as casas consultadas |
meta.future_id, meta.books_count, meta.selections_count | Removidos |
| - | id, market, name, is_main, team_id em cada registro |
| - | Parâmetros de consulta future_type, team_id, selection, is_main |
RelacionadosLink permanente para esta seção
- Servidor MCP (Assistentes de IA) - as ferramentas
get_futures,get_futures_oddsecompare_futures_linesleem estes endpoints - Ligas - os ids de liga a passar como
league - Formatos de Odds - americanas, decimais e probabilidade implícita