Skip to Content

Ligas

Obtén una lista de ligas disponibles con filtrado opcional por deporte.

GET /api/v1/leagues

Requiere una API key. Disponible en todos los planes (Free incluido). Las solicitudes no autenticadas devuelven 401.

Parámetros de ConsultaEnlace permanente a esta sección

ParámetroTipoPor defectoDescripción
sportstringallFiltra por deporte (p. ej., basketball, football). Solo IDs de deporte; un ID de liga como nba va en league (detalles).

Ejemplos de SolicitudesEnlace permanente a esta sección

# Listar todas las ligas curl -X GET "https://api.sharpapi.io/api/v1/leagues" \ -H "X-API-Key: YOUR_API_KEY" # Filtrar por deporte curl -X GET "https://api.sharpapi.io/api/v1/leagues?sport=basketball" \ -H "X-API-Key: YOUR_API_KEY"

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección

{ "data": [ { "id": "nba", "name": "NBA", "sport": "basketball", "event_count": 15, "live_count": 2 }, { "id": "ncaab", "name": "NCAAB", "sport": "basketball", "event_count": 27, "live_count": 1 }, { "id": "wnba", "name": "WNBA", "sport": "basketball", "event_count": 0, "live_count": 0 } ], "meta": { "count": 3, "total": 3, "pagination": { "limit": 50, "offset": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-01-26T12:00:00Z", "filters": { "sport": "basketball" } } }

Todas las Ligas (Sin Filtro)Enlace permanente a esta sección

{ "data": [ { "id": "nba", "name": "NBA", "sport": "basketball", "event_count": 15, "live_count": 2 }, { "id": "ncaab", "name": "NCAAB", "sport": "basketball", "event_count": 27, "live_count": 1 }, { "id": "wnba", "name": "WNBA", "sport": "basketball", "event_count": 0, "live_count": 0 }, { "id": "nfl", "name": "NFL", "sport": "football", "event_count": 16, "live_count": 1 }, { "id": "ncaaf", "name": "NCAAF", "sport": "football", "event_count": 12, "live_count": 0 }, { "id": "nhl", "name": "NHL", "sport": "hockey", "event_count": 15, "live_count": 2 }, { "id": "mlb", "name": "MLB", "sport": "baseball", "event_count": 0, "live_count": 0 }, { "id": "epl", "name": "English Premier League", "sport": "soccer", "event_count": 10, "live_count": 2 }, { "id": "la_liga", "name": "La Liga", "sport": "soccer", "event_count": 10, "live_count": 1 }, { "id": "serie_a", "name": "Serie A", "sport": "soccer", "event_count": 10, "live_count": 1 }, { "id": "bundesliga", "name": "Bundesliga", "sport": "soccer", "event_count": 5, "live_count": 0 }, { "id": "mls", "name": "MLS", "sport": "soccer", "event_count": 0, "live_count": 0 }, { "id": "atp", "name": "ATP", "sport": "tennis", "event_count": 12, "live_count": 4 }, { "id": "wta", "name": "WTA", "sport": "tennis", "event_count": 6, "live_count": 2 }, { "id": "ufc", "name": "UFC", "sport": "mma", "event_count": 12, "live_count": 0 }, { "id": "pga", "name": "PGA Tour", "sport": "golf", "event_count": 4, "live_count": 1 } ], "meta": { "count": 16, "total": 16, "pagination": { "limit": 50, "offset": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-01-26T12:00:00Z", "filters": {} } }

Esquema del Objeto LeagueEnlace permanente a esta sección

CampoTipoDescripción
idstringIdentificador de la liga (en minúsculas, usar en filtros de API)
namestringNombre legible de la liga
sportstringID del deporte principal
event_countintegerNúmero de partidos de la liga con cuotas en este momento. Los mercados de futuros no se cuentan. Cambio (noviembre de 2026); vea más abajo.
live_countintegerPartidos actualmente en directo/en juego (nunca más que event_count)

Cambio (noviembre de 2026): event_count y live_count cuentan solo partidos. Antes contaban cada evento de la liga con cuotas, incluidos los mercados de futuros. Ahora cuentan solo partidos: un mercado de futuros, como el campeón de una liga, no se cuenta, así que una liga con muchos futuros muestra un número menor que antes, y una liga que en este momento solo tiene futuros muestra 0 y sigue en la lista. Los futuros y sus cuotas están en los endpoints de futuros (Enterprise).

Ligas ComunesEnlace permanente a esta sección

El endpoint es la fuente canónica de verdad — llama a GET /api/v1/leagues para obtener la lista completa y actualizada. El registro atlas cataloga más de 600 ligas en más de 30 deportes, incluyendo competiciones continentales de la UEFA, múltiples circuitos de baloncesto por país y cobertura completa de tenis/golf/MMA/esports/críquet. El subconjunto ilustrativo a continuación muestra las entradas de mayor volumen sobre las que normalmente filtrarás:

DeporteIDs de ligas comunes
Basketballnba, ncaab, wnba
Footballnfl, ncaaf
Hockeynhl
Baseballmlb
Soccerengland_-_premier_league, spain_-_la_liga, italy_-_serie_a, germany_-_bundesliga, france_-_ligue_1, uefa_-_champions_league, usa_-_major_league_soccer
Tennisatp, wta, atp_challenger, itf_men, itf_women
MMAufc, pfl
Golfpga, liv, dp_world_tour, lpga
  • Los IDs de liga utilizan la forma canónica de slug (england_-_premier_league, no epl). Algunas formas cortas se aceptan como entrada de filtro por compatibilidad con versiones anteriores, pero el slug canónico es lo que devuelve /leagues y lo que otros endpoints emiten en las cargas útiles de respuesta.
  • Los valores de event_count y live_count son dinámicos. Las ligas fuera de temporada (p. ej., MLB en invierno, WNBA en otoño) muestran 0 pero permanecen en el catálogo, también mientras sus mercados de futuros están abiertos.
  • Para acceso programático (p. ej., al construir filtros desplegables), llama a /api/v1/leagues y utiliza la respuesta — nunca codifiques una lista de forma estática.

Uso de Ligas en FiltrosEnlace permanente a esta sección

Usa el id de la liga como parámetro de filtro en otros endpoints:

# Obtener cuotas de la NBA curl "https://api.sharpapi.io/api/v1/odds?league=nba" \ -H "X-API-Key: YOUR_API_KEY" # Obtener las mejores cuotas para NFL y NBA curl "https://api.sharpapi.io/api/v1/odds/best?league=nfl,nba" \ -H "X-API-Key: YOUR_API_KEY"

Endpoints RelacionadosEnlace permanente a esta sección

Last updated on