msport.com APIwww.msport.com ↗
Access real-time betting odds from MSport Nigeria via 3 endpoints. List sports, fetch matches with main market odds, and retrieve all markets for any match.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ed788d1a-1d1c-4a3a-aa56-1658f52cbd71/list_sports' \ -H 'X-API-Key: $PARSE_API_KEY'
List all available sports on MSport Nigeria with their current match counts. Returns sport IDs needed for the get_matches endpoint.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer",
"sports": "array of sport objects with sport_id, sport_name, match_count"
},
"sample": {
"total": 24,
"sports": [
{
"sport_id": "sr:sport:1",
"sport_name": "Soccer",
"match_count": 498
},
{
"sport_id": "sr:sport:2",
"sport_name": "Basketball",
"match_count": 56
},
{
"sport_id": "sr:sport:5",
"sport_name": "Tennis",
"match_count": 204
}
]
}
}About the msport.com API
The MSport Nigeria API gives developers access to betting odds data across all sports on msport.com/ng through 3 endpoints. The get_matches endpoint returns matches grouped by tournament with main market odds including 1x2, Over/Under, and more. The get_match_odds endpoint exposes full market depth — Double Chance, GG/NG, DNB, and other bet types — alongside outcome probabilities, team names, and match status for any event ID.
Sports and Match Discovery
The list_sports endpoint returns every sport currently active on MSport Nigeria, including each sport's sport_id, sport_name, and match_count. The sport_id values (e.g. sr:sport:1 for Soccer, sr:sport:2 for Basketball) are the inputs needed by get_matches. The total field confirms how many sports are available at the time of the call.
Match Listings with Main Market Odds
Passing a sport_id to get_matches returns all upcoming matches for that sport, grouped by tournament. You can narrow results with the optional date parameter (format: YYYY-MM-DD). Each match object includes team names, start times, and main market odds — typically 1x2 and Over/Under lines. The response total field indicates how many matches are returned.
Full Market Depth per Match
The get_match_odds endpoint accepts an event_id string (e.g. sr:match:71766878, obtainable from get_matches) and returns all available betting markets for that specific match. Response fields include home_team, away_team, start_time (Unix timestamp in milliseconds), status (0 = not started, 1 = live), score, sport, category, and a markets array. Each market object lists individual outcomes with their associated probabilities. Markets vary by event but can include 1x2, Over/Under, Double Chance, GG/NG, and DNB.
- Build a pre-match odds comparison tool using 1x2 and Over/Under data from
get_matches - Track live match status and in-play scores via the
statusandscorefields inget_match_odds - Aggregate market counts per sport using
match_countfromlist_sportsfor a sports activity dashboard - Filter today's football matches using
get_matcheswith adateparameter andsr:sport:1 - Calculate implied probabilities from outcome probability data returned by
get_match_odds - Alert users when specific bet markets (e.g. Double Chance or DNB) become available for a match
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MSport have an official developer API?+
What does `get_match_odds` return beyond the main odds lines?+
get_match_odds returns the full markets array for a match, which can include 1x2, Over/Under, Double Chance, GG/NG (both teams to score), and DNB (Draw No Bet). Each market entry includes its outcomes and their probabilities. It also returns match metadata: home_team, away_team, start_time (millisecond Unix timestamp), current score, status, sport, and category.Are historical match results or past odds covered?+
get_matches returns upcoming fixtures and get_match_odds includes live status via the status field. Historical results and past odds lines are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting historical match data.Can I retrieve odds for a specific league or tournament directly?+
get_matches endpoint filters by sport_id and optionally date, but does not accept a league or tournament parameter. Matches are returned grouped by tournament within the response, so tournament filtering would need to be applied client-side. You can fork this API on Parse and revise it to add a tournament-level filter endpoint.Does the API cover sports other than football on MSport Nigeria?+
list_sports returns all active sports along with their sport_id values. Basketball uses sr:sport:2, and any other sports listed on MSport Nigeria at query time will appear in the response with their own IDs and match_count values, which you can then pass to get_matches.