Odds do Evento

Obtenha todas as odds de um evento específico com filtragem opcional por sportsbook e tipo de mercado. Retorna uma lista paginada de entradas de odds.


GET /api/v1/events/{eventId}/odds

Este é um endpoint de conveniência equivalente a GET /api/v1/odds?event={eventId}. Ambos retornam os mesmos dados; use o que melhor se adequar à sua estrutura de URL.

AutenticaçãoPermalink for this section

Requer API key via header X-API-Key, header Authorization: Bearer ou parâmetro de query api_key. Disponível em todos os planos.

Parâmetros de PathPermalink for this section

Parâmetro	Tipo	Obrigatório	Descrição
`eventId`	string	Sim	Identificador único do evento (ex.: `evt_nba_bos_lal_20260208`)

Parâmetros de QueryPermalink for this section

Parâmetro	Tipo	Padrão	Descrição
`sportsbook`	string	all	Filtrar por sportsbook. Separado por vírgulas para múltiplos (ex.: `draftkings,pinnacle`)
`market`	string	all	Filtrar por tipo de mercado. Separado por vírgulas para múltiplos (ex.: `moneyline,spread`)
`limit`	integer	50	Resultados por página (máximo 200)
`offset`	integer	0	Offset de paginação

Headers de RespostaPermalink for this section

Todas as respostas incluem headers padrão de rate limit e metadados:

Header	Descrição
`X-RateLimit-Limit`	Máximo de requisições por minuto para o seu plano
`X-RateLimit-Remaining`	Requisições restantes na janela atual
`X-RateLimit-Reset`	Timestamp Unix de quando a janela de rate limit é redefinida
`X-Data-Delay`	Atraso de dados para o seu plano (ex.: `0s`, `60s`)
`X-Request-Id`	Identificador único da requisição para depuração

Objeto OddsPermalink for this section

Campo	Tipo	Descrição
`id`	string	Identificador único da odd
`sportsbook`	string	Identificador do sportsbook (ex.: `draftkings`, `pinnacle`)
`event_id`	string	Identificador do evento pai
`market_type`	string	Tipo de mercado: `moneyline`, `spread`, `total`, `player_prop`, etc.
`selection`	string	A seleção (nome do time, nome do jogador, Over/Under)
`selection_type`	string	`home`, `away`, `over`, `under`
`line`	number \| null	Valor da linha para mercados de spread/total, `null` para moneyline
`odds.american`	number	Odds americanas (ex.: -110, +150)
`odds.decimal`	number	Odds decimais (ex.: 1.909)
`odds.probability`	number	Probabilidade implícita (ex.: 0.5238)
`timestamp`	string	Horá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 (corresponde ao `timestamp` da OpticOdds); não é quando o preço mudou pela última vez. Veja Entendendo o campo `timestamp`.

Exemplos de RequisiçõesPermalink for this section

Obter todas as odds de um eventoPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
const response = await fetch(
  `https://api.sharpapi.io/api/v1/events/${eventId}/odds`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`${meta.total} total odds for this event`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
print(f"{result['meta']['total']} total odds for this event")

Filtrar por sportsbook e mercadoPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
const response = await fetch(
  `https://api.sharpapi.io/api/v1/events/${eventId}/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
    params={
        'sportsbook': 'draftkings,pinnacle',
        'market': 'moneyline,spread'
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
odds = response.json()['data']

Paginar por todas as oddsPermalink for this section

cURL


# Primeira página
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=0" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Próxima página
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=50" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
let offset = 0;
const limit = 50;
let allOdds = [];
 
while (true) {
  const response = await fetch(
    `https://api.sharpapi.io/api/v1/events/${eventId}/odds?limit=${limit}&offset=${offset}`,
    { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
  );
  const { data, meta } = await response.json();
  allOdds = allOdds.concat(data);
 
  if (!meta.pagination.has_more) break;
  offset = meta.pagination.next_offset;
}
 
console.log(`Fetched all ${allOdds.length} odds`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
all_odds = []
offset = 0
limit = 50
 
while True:
    response = requests.get(
        f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
        params={'limit': limit, 'offset': offset},
        headers={'X-API-Key': 'YOUR_API_KEY'}
    )
    result = response.json()
    all_odds.extend(result['data'])
 
    if not result['meta']['pagination']['has_more']:
        break
    offset = result['meta']['pagination']['next_offset']
 
print(f"Fetched all {len(all_odds)} odds")

RespostaPermalink for this section

Sucesso (200)Permalink for this section


{
  "data": [
    {
      "id": "dk_evt_nba_bos_lal_20260208_ml_home",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "moneyline",
      "selection": "Boston Celtics",
      "selection_type": "home",
      "line": null,
      "odds": {
        "american": -180,
        "decimal": 1.556,
        "odds_probability": 0.643
      },
      "timestamp": "2026-02-08T12:05:00Z"
    },
    {
      "id": "dk_evt_nba_bos_lal_20260208_ml_away",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "moneyline",
      "selection": "Los Angeles Lakers",
      "selection_type": "away",
      "line": null,
      "odds": {
        "american": 155,
        "decimal": 2.55,
        "odds_probability": 0.392
      },
      "timestamp": "2026-02-08T12:05:00Z"
    },
    {
      "id": "pin_evt_nba_bos_lal_20260208_ml_home",
      "sportsbook": "pinnacle",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "moneyline",
      "selection": "Boston Celtics",
      "selection_type": "home",
      "line": null,
      "odds": {
        "american": -175,
        "decimal": 1.571,
        "odds_probability": 0.636
      },
      "timestamp": "2026-02-08T12:03:00Z"
    },
    {
      "id": "dk_evt_nba_bos_lal_20260208_spread_home",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "spread",
      "selection": "Boston Celtics",
      "selection_type": "home",
      "line": -6.5,
      "odds": {
        "american": -110,
        "decimal": 1.909,
        "odds_probability": 0.524
      },
      "timestamp": "2026-02-08T12:05:00Z"
    },
    {
      "id": "dk_evt_nba_bos_lal_20260208_total_over",
      "sportsbook": "draftkings",
      "event_id": "evt_nba_bos_lal_20260208",
      "market_type": "total",
      "selection": "Over",
      "selection_type": "over",
      "line": 224.5,
      "odds": {
        "american": -110,
        "decimal": 1.909,
        "odds_probability": 0.524
      },
      "timestamp": "2026-02-08T12:05:00Z"
    }
  ],
  "meta": {
    "count": 5,
    "total": 48,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-02-08T12:05:00Z",
    "filters": {
      "sportsbook": "all",
      "market": "all"
    }
  }
}

Respostas de ErroPermalink for this section

404 Not Found


{
  "error": {
    "code": "not_found",
    "message": "Event not found",
    "docs": "https://docs.sharpapi.io/en/api-reference/events-odds"
  }
}

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

429 Rate Limited


{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Upgrade your tier for higher limits.",
    "docs": "https://docs.sharpapi.io/en/pricing"
  }
}

Endpoints RelacionadosPermalink for this section

Eventos - Listar e buscar eventos
Detalhes do Evento - Obter detalhes do evento com dados de mercado incorporados
Mercados do Evento - Listar tipos de mercado disponíveis para um evento
Snapshot de Odds - Obter odds em todos os eventos
Melhores Odds - Obter as melhores odds em todos os sportsbooks