Liga MX API
Realtime Sports API serves Mexican Liga MX games through the same REST endpoints and JSON schema as every other league, using sport=soccer and league=mex.1. You get the current scoreboard, live scores, game detail, play-by-play, teams, rosters and news, plus current odds and line history from a single source book. Not currently available or not verified for this league: injuries, player box-score stats. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.
- Slugs
- sport=soccer
league=mex.1 - Teams
- 18
- Season (from data)
- 2026-27 Liga BBVA MX Torneo Apertura
- In the scoreboard now
- 4 games
Upcoming and live Liga MX games
| Date | Away | Home | Time / Result | TV | Venue |
|---|---|---|---|---|---|
| Sat, Nov 21 | Toluca | atPachuca | 5:50 PM ET | TV: | Estadio Hidalgo · Pachuca |
| Sat, Nov 21 | León | atSantos | 6:00 PM ET | TV: | Estadio Corona · Torreón |
| Sat, Nov 21 | Monterrey | atPumas UNAM | 8:00 PM ET | TV: | Estadio Olímpico Universitario · Mexico City |
| Sat, Nov 21 | América | atTigres UANL | 10:00 PM ET | TV: | Estadio Universitario · San Nicolás de los Garza |
From the /events endpoint for this league, refreshed every few minutes. Times are US Eastern. Full Liga MX schedule · Liga MX team APIs · Free Liga MX scoreboard widget
Live example
Request
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/mex.1/events?limit=1"Response captured from live data at 2026-11-21 18:07 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.
Response
{
"success": true,
"data": [
{
"id": "401877050",
"uid": "s:600~l:760~e:401877050",
"name": "Toluca at Pachuca",
"shortName": "TOL @ PAC",
"date": "2026-11-21T22:50Z",
"status": {
"state": "pre",
"completed": false,
"period": 0,
"clock": "0'",
"detail": "Sat, November 21st at 5:50 PM EST",
"halftime": false,
"firstHalfEnded": false
},
"homeTeam": {
"id": "234",
"name": "Pachuca",
"abbreviation": "PAC",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXQAOWRMQEENcUx1GVglCH0pXAQ",
"color": "001C58",
"alternateColor": "02b0d0",
"winner": false,
"score": 0
},
"awayTeam": {
"id": "223",
"name": "Toluca",
"abbreviation": "TOL",
"logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXQAOWRMQEENcUx1GVghFH0pXAQ",
"color": "EF0107",
"alternateColor": "ffffff",
"winner": false,
"score": 0
},
"competition": {
"attendance": 0,
"neutralSite": false,
"conferenceCompetition": false,
"divisionCompetition": false,
"playByPlayAvailable": true,
"highlightsAvailable": false
},
"venue": {
"id": "10645",
"name": "Estadio Hidalgo",
"city": "Pachuca",
"indoor": false,
"grass": false
},
"notes": [],
"season": {
"year": 2026,
"displayName": "2026-27 Liga BBVA MX",
"type": {
"id": "1",
"name": "Torneo Apertura",
"abbreviation": "2026 Liga MX Apertura"
},
"week": {}
},
"broadcasts": [],
"officials": []
}
],
"meta": {
"rateLimit": {
"limit": 125,
"remaining": 124,
"reset": 1796083200000
}
}
}Liga MX endpoints
Checked against live data on 2026-10-04. Paths are relative to /api/v1/sports/soccer/leagues/mex.1.
| Endpoint | Path | Liga MX | Notes |
|---|---|---|---|
| Live scores | /events/live | Available | |
| Events (scoreboard) | /events | Available | |
| Event detail | /events/{eventId} | Available | |
| Play-by-play | /events/{eventId}/plays | Available | |
| Box score | /events/{eventId}/boxscore | Limited | Team totals and period scores only; player stats are not returned. |
| Odds | /events/{eventId}/odds | Available | |
| Win probability | /events/{eventId}/winprobability | Not available | |
| Teams | /teams | Available | |
| Rosters | /teams/{teamId}/roster | Available | |
| Athletes | /athletes/search | Available | |
| Injuries | /injuries | Not available | |
| News | /news | Available | |
| Schedule / weeks | /seasons/{season}/schedule | Available | |
| NCAA tournament | /seasons/{season}/tournament | Not available | |
| Rankings | /rankings | Not available | |
| Webhooks | /webhooks | Available | |
| WebSocket | /websocket/auth | Available |
- Schedules are by date, not week: use /events for the current scoreboard and /seasons/{season}/schedule for a season. Week parameters return SCHEDULE_WEEKS_NOT_SUPPORTED.
- Soccer play-by-play is a stream of match events (passes, shots, fouls, cards); box scores carry team totals and period scores without player rows.
Every Liga MX game in the events, live and schedule endpoints uses the same Event object as other leagues: Event object field reference.
Liga MX API in Python, JavaScript and curl
curl
curl -H "Authorization: Bearer $RSA_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/mex.1/events?limit=5"JavaScript (fetch)
const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/mex.1/events?limit=5", {
headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { success, data, meta } = await res.json();
console.log(data, meta.rateLimit);Python (requests)
import os, requests
res = requests.get(
"https://www.realtimesportsapi.com/api/v1/sports/soccer/leagues/mex.1/events?limit=5",
headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
timeout=10,
)
body = res.json()
print(body["data"])MCP prompt (Claude, Cursor, ChatGPT)
Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_events with sport "soccer" and league "mex.1" and list the games it returns with start times, status and scores for Liga MX.Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.
Each request above is 1 call. Free covers 125 calls a month after a 1,000-call first month, at 1 request/second. Starter is $29/month for 10,000 calls (about 333 a day) plus webhooks and WebSocket, so you stop polling for changes; 7-day free trial. Compare plans
Real-time Liga MX push: WebSocket and webhooks
Instead of polling, paid plans can receive every Liga MX game start, score change and final as it is detected (typically 20-30 seconds behind live play): a Liga MX WebSocket feed for live dashboards and apps, or Liga MX webhooks that POST each event to your server. On the Free plan you can watch the stream and send yourself a sample webhook from the dashboard.
Shipping a product with Liga MX data?
Polling works on every plan. Production apps usually also want events pushed to them, by webhook or WebSocket, as soon as we detect them (typically 20-30 seconds behind live play). These guides show the setup and the plan each one needs.
- Score alerts for your sports app, without pollingWebhooks into your backend, then FCM/APNs · Starter ($29/mo)
- Live scoreboards and game pages for news and media sitesCached REST on your server; optional WebSocket for live ticks · Starter ($29/mo)
- Player stats and box scores for fantasy platformsREST box scores during games, webhooks for finals and plays · Growth ($49/mo)
- Live scores on the screens in your venueFree widget, or one WebSocket feeding every screen · Starter ($29/mo)
- A play-by-play feed for your analytics stackWebSocket for live plays, REST to backfill and reconcile · Growth ($49/mo)
- Stream live scores to your backend over WebSocketWebSocket (server to server) · Starter ($29/mo)
- Sports data for a startup, from prototype to scaleREST, WebSocket and webhooks on one key · Starter ($29/mo)
Liga MX API pricing and rate limits
The Liga MX API is included in every plan, Free included: one key covers all leagues. Free starts with 1,000 calls in your first 30 days (no card); paid plans start at $29/month with a 7-day free trial.
| Plan | Price | Calls | Rate | WebSocket | Webhooks |
|---|---|---|---|---|---|
| Free | $0 | 125/mo (1,000 first 30 days) | 1/s | 500 msgs/mo | No |
| Starter | $29/mo ($290/yr) | 10,000/mo | 5/s | Shares monthly pool | Shares monthly pool |
| Growth | $49/mo ($490/yr) | 25,000/mo | 10/s | Shares monthly pool | Shares monthly pool |
| Pro | $99/mo ($990/yr) | 50,000/mo | 20/s | 100,000 msgs/mo | 25,000/mo |
| Business | $179/mo ($1,790/yr) | 150,000/mo | 40/s | 300,000 msgs/mo | 75,000/mo |
| Scale | $299/mo ($2,990/yr) | 500,000/mo | 100/s | 500,000 msgs/mo | 100,000/mo |
Every successful REST call counts as one call. Over the limit you get HTTP 429 with a Retry-After header. No SLA. Full pricing.
29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.
FAQ
- Is there a free Liga MX API?
- Yes. The Free plan is $0 with 125 calls per month (1,000 in the first 30 days) at 1 request per second, no card required. The same key works for all 29 leagues.
- How fresh is the Liga MX data?
- Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA. It is not intended for in-play betting that needs sub-second data.
- Which Liga MX endpoints are available?
- Available: live scores, events (scoreboard), event detail, play-by-play, odds, teams, rosters, athletes, news, schedule / weeks. Not available or not verified: box score (limited), win probability (not available), injuries (not available), ncaa tournament (not available), rankings (not available).
- Does the Liga MX API include betting odds?
- Yes. Upcoming Liga MX games returned a spread, moneyline and total when we checked, from a single source book, with line history. It is not a multi-book comparison feed and not suited to sub-second in-play betting.
- Does it include Liga MX injuries?
- No. The injuries endpoint returned no records for Liga MX when we checked, so treat injuries as not available for this league.
- Can I get Liga MX score updates pushed instead of polling?
- Yes. Webhooks are included on every paid plan (Starter, Growth, Pro, Business, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview. Both can be filtered to mex.1.