Mejores Cuotas

Obtén las mejores cuotas disponibles para cada selección entre todas las casas de apuestas. Este endpoint compara las cuotas de todas las casas disponibles en tu plan y devuelve la línea más favorable para cada selección, junto con comparaciones por casa y cálculos de margen.


GET /api/v1/odds/best

AutenticaciónPermalink for this section

Requiere API key. Disponible en todos los planes.

Best Odds está disponible en todos los planes, incluido el Free. Las casas de apuestas comparadas dependen del acceso a casas de tu plan (Free compara DraftKings y FanDuel; Pro+ incluye Pinnacle).

Parámetros de ConsultaPermalink for this section

Parámetro	Tipo	Por defecto	Descripción
`sport`	string	all	Filtrar por deporte(s), separados por comas (p. ej., `basketball`, `football`)
`league`	string	all	Filtrar por liga(s), separadas por comas (p. ej., `nba`, `nfl`)
`market`	string	all	Filtrar por tipo(s) de mercado, separados por comas (p. ej., `moneyline`, `spread`, `total`). Admite alias de categoría — consulta Odds: Alias de Categoría de Mercado.
`event`	string	—	Filtrar por ID(s) de evento, separados por comas
`live`	boolean	—	`true` = solo en vivo, `false` = solo prepartido, omitir = ambos
`min_odds`	number	—	Filtro mínimo de cuotas americanas
`max_odds`	number	—	Filtro máximo de cuotas americanas
`limit`	integer	50	Resultados máximos por página (máx. 200)
`offset`	integer	0	Desplazamiento de paginación (máx. 5000)

Las cuotas obsoletas (con más de 5 minutos para prepartido, 1 minuto para en vivo) se excluyen automáticamente de las comparaciones de mejores cuotas para evitar resultados engañosos.

Ejemplos de SolicitudesPermalink for this section

cURL


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

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/odds/best?league=nba&market=spread',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
 
data.forEach(item => {
  console.log(
    `${item.selection}: Best ${item.best_odds.american} at ${item.best_book}` +
    ` (${item.all_books.length} books compared)`
  );
});

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/odds/best',
    params={'league': 'nba', 'market': 'spread'},
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
 
for item in result['data']:
    best = item['best_odds']['american']
    book = item['best_book']
    books = len(item['all_books'])
    print(f"{item['selection']}: Best {best} at {book} ({books} books compared)")

RespuestaPermalink for this section

Éxito (200)Permalink for this section


{
  "success": true,
  "data": [
    {
      "event_id": "evt_nba_lal_bos_20260126",
      "event_name": "Los Angeles Lakers @ Boston Celtics",
      "sport": "basketball",
      "league": "nba",
      "market_type": "spread",
      "selection": "Boston Celtics",
      "line": -6.5,
      "best_odds": {
        "american": -105,
        "decimal": 1.952,
        "odds_probability": 0.512
      },
      "best_book": "fanduel",
      "all_books": [
        {
          "book": "fanduel",
          "odds": { "american": -105, "decimal": 1.952 },
          "edge": 0.007,
          "line": -6.5
        },
        {
          "book": "draftkings",
          "odds": { "american": -110, "decimal": 1.909 },
          "edge": 0.0,
          "line": -6.5
        },
        {
          "book": "betmgm",
          "odds": { "american": -108, "decimal": 1.926 },
          "edge": 0.003,
          "line": -6.5
        },
        {
          "book": "pinnacle",
          "odds": { "american": -108, "decimal": 1.926 },
          "edge": 0.003,
          "line": -6.5
        }
      ],
      "timestamp": "2026-01-26T10:30:00.000Z"
    }
  ],
  "meta": {
    "count": 1,
    "total": 48,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": false,
      "next_offset": null
    },
    "updated_at": "2026-01-26T10:30:05.000Z",
    "filters": {
      "league": "nba",
      "market": "spread"
    }
  }
}

Cabeceras de RespuestaPermalink for this section


X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 1737853200
X-Data-Delay: 0
X-Request-Id: req_best_789xyz

Respuestas de ErrorPermalink for this section

401 Unauthorized


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

429 Rate Limited


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

Esquema del Objeto Best OddsPermalink for this section

Campo	Tipo	Descripción
`event_id`	string	Identificador del evento
`event_name`	string	Nombre visible del evento (p. ej., “Lakers @ Celtics”)
`sport`	string	Slug del deporte
`league`	string	Slug de la liga
`market_type`	string	Tipo de mercado (p. ej., `moneyline`, `spread`, `total`)
`selection`	string	Nombre de la selección (nombre del equipo, Over/Under)
`line`	number \| null	Valor de la línea (para spreads/totales)
`best_odds`	object	Mejores cuotas disponibles entre todas las casas
`best_odds.american`	number	Mejores cuotas americanas
`best_odds.decimal`	number	Mejores cuotas decimales
`best_odds.probability`	number	Probabilidad implícita de las mejores cuotas
`best_book`	string	ID de la casa de apuestas con las mejores cuotas
`all_books`	array	Cuotas de todas las casas de apuestas para esta selección
`all_books[].book`	string	ID de la casa de apuestas
`all_books[].odds`	object	Objeto de cuotas (`american`, `decimal`)
`all_books[].edge`	number	Margen sobre las peores cuotas disponibles (puntos porcentuales)
`all_books[].line`	number \| null	Línea en esta casa de apuestas
`timestamp`	string	Marca temporal ISO 8601 de la determinación de las mejores cuotas
`player_name`	string\|undefined	Nombre del jugador (solo mercados de player props)
`stat_category`	string\|undefined	Categoría estadística, p. ej. `points`, `rebounds` (solo mercados de player props)

Pinnacle se utiliza habitualmente como referencia sharp. Cuando Pinnacle está disponible en all_books, puedes identificarla mediante book: "pinnacle" y comparar sus cuotas con las de las soft books para encontrar oportunidades +EV.

Por Qué Importan las Mejores CuotasPermalink for this section

Encontrar las mejores cuotas disponibles es la base de las apuestas deportivas rentables:

1. Comparar Líneas Ahorra DineroPermalink for this section

La diferencia entre -105 y -110 puede parecer pequeña, pero se acumula drásticamente con el tiempo:

Cuotas	Ganancia con apuesta de $100	Tasa de Equilibrio
-115	+$87	53,5%
-110	+$91	52,4%
-105	+$95	51,2%
+100	+$100	50,0%

2. Impacto a Largo PlazoPermalink for this section

A lo largo de 1.000 apuestas con una tasa de acierto del 52%:

Cuotas Consistentes	Resultado Neto
-115	-$44 de pérdida
-110	+$18 de beneficio
-105	+$80 de beneficio

3. Comparación de MargenPermalink for this section

El campo edge de cada casa en all_books muestra cuánto mejores (o peores) son las cuotas de esa casa en comparación con la peor línea disponible, ayudándote a cuantificar el valor de comparar entre casas.

Endpoints RelacionadosPermalink for this section

Snapshot de Cuotas - Obtén cuotas en bruto de casas de apuestas individuales
Delta de Cuotas - Obtén solo las cuotas que han cambiado desde una marca temporal dada
Comparación de Cuotas - Compara cuotas lado a lado entre casas
Casas de Apuestas - Consulta qué casas están disponibles y su estado