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ón

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 Consulta

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 Solicitudes

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)")

Respuesta

Éxito (200)


{
  "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,
          "last_seen_at": "2026-01-26T10:30:00.000Z"
        },
        {
          "book": "draftkings",
          "odds": { "american": -110, "decimal": 1.909 },
          "edge": 0.0,
          "line": -6.5,
          "last_seen_at": "2026-01-26T10:29:55.000Z"
        },
        {
          "book": "betmgm",
          "odds": { "american": -108, "decimal": 1.926 },
          "edge": 0.003,
          "line": -6.5,
          "last_seen_at": "2026-01-26T10:29:50.000Z"
        },
        {
          "book": "pinnacle",
          "odds": { "american": -108, "decimal": 1.926 },
          "edge": 0.003,
          "line": -6.5,
          "last_seen_at": "2026-01-26T10:29:45.000Z"
        }
      ],
      "last_seen_at": "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 Respuesta


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

Respuestas de Error

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 Odds

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
`all_books[].last_seen_at`	string	Cuándo nuestra pipeline observó por última vez la fila de esta casa — señal de frescura de la pipeline
`all_books[].odds_changed_at`	string	Cuándo cambió realmente por última vez el precio, la línea o el indicador `is_live` de esta casa. En Pinnacle, se mantiene durante actualizaciones sin cambios — consulta Entendiendo el `odds_changed_at` de Pinnacle.
`last_seen_at`	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 Cuotas

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

1. Comparar Líneas Ahorra Dinero

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 Plazo

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 Margen

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 Relacionados

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