Melbet APImelbet.ng ↗
Fetch sports, tournaments, and betting odds from Melbet Nigeria via 3 endpoints. Access pre-match and live markets including Result, Double Chance, Total, and Handicap.
What is the Melbet API?
The Melbet Nigeria API provides structured access to sports betting data across 3 endpoints, covering sports listings, tournament discovery, and per-event odds markets. The get_event_odds endpoint returns match details with odds for Result (W1/X/W2), Double Chance, Total (Over/Under), and Handicap markets for any tournament retrieved from list_tournaments. The API covers both pre-match and live event data as available on melbet.ng.
curl -X GET 'https://api.parse.bot/scraper/74728b97-3711-47f2-b1e3-dc54b7cf9ac0/list_sports?sport_type=prematch' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace melbet-ng-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Melbet SDK — browse sports, tournaments, and live odds."""
from parse_apis.Melbet_Sports_Betting_Odds_API import Melbet, SportType, ParseError
melbet = Melbet()
# List all pre-match sports with event counts
for sport in melbet.sports.list(sport_type=SportType.PREMATCH, limit=5):
print(sport.name, sport.event_count, sport.live_count)
# Navigate from a sport to its tournaments
football = melbet.sport(id=1)
for tournament in football.tournaments.list(limit=3):
print(tournament.id, tournament.name, tournament.event_count)
# Drill into a tournament's events and inspect full odds with line values
world_cup = melbet.tournament(id=52530)
event = world_cup.events.list(limit=1).first()
if event:
print(event.name, event.home_team, "vs", event.away_team, event.start_time)
for market_name, selections in event.odds.items():
for sel in selections:
print(f" {market_name}: {sel.name} @ {sel.odds}")
# Typed error handling
try:
bad_tournament = melbet.tournament(id=99999999)
for ev in bad_tournament.events.list(limit=1):
print(ev.name)
except ParseError as exc:
print(f"Error: {exc}")
print("exercised: sports.list / tournaments.list / events.list / sport() / tournament()")
List all available sports with their event counts. Returns both pre-match and live sports depending on sport_type. Each sport includes an ID usable with list_tournaments to drill into that sport's tournament tree. Paginates as a single page.
| Param | Type | Description |
|---|---|---|
| sport_type | string | Type of sports listing. |
{
"type": "object",
"fields": {
"total": "integer total number of sports",
"sports": "array of sport objects with id, name, name_english, event_count, live_count, sort_id"
},
"sample": {
"data": {
"total": 41,
"sports": [
{
"id": 1,
"name": "Football",
"sort_id": 1,
"live_count": 0,
"event_count": 662,
"name_english": "Football"
},
{
"id": 4,
"name": "Basketball",
"sort_id": 3,
"live_count": 0,
"event_count": 83,
"name_english": "Basketball"
}
]
},
"status": "success"
}
}About the Melbet API
Sports and Tournament Discovery
The list_sports endpoint returns all sports available on Melbet Nigeria, including each sport's id, name, name_english, event_count, live_count, and sort_id. The optional sport_type parameter accepts either prematch or live, letting you filter the listing to the relevant segment. The total count field gives a quick summary of how many sports are active at query time.
The list_tournaments endpoint accepts a sport_id — for example 1 for Football or 4 for Basketball — and returns every tournament or championship available for that sport. Each tournament object includes an id, name, and event_count. These tournament IDs are the required input for retrieving actual odds data.
Event Odds Detail
The get_event_odds endpoint accepts a tournament_id (such as 5659 for the UEFA Super Cup or 4584 for the UEFA Champions League) and returns an events array alongside tournament_name, region, sport, and total_events. Each event object carries match info and odds covering four markets: Result (W1/X/W2 for win/draw/loss), Double Chance, Total (Over/Under lines), and Handicap. This gives enough structure to compare odds across events within a single tournament or to track specific market lines over time.
Coverage Notes
Data reflects what is currently active on melbet.ng for the Nigerian market. Live event availability depends on what matches are in progress at query time, so live_count values on list_sports will vary. Tournament and event availability is sport-dependent — not every sport will have the same breadth of competitions listed.
The Melbet API is a managed, monitored endpoint for melbet.ng — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when melbet.ng changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official melbet.ng API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor odds movements for W1/X/W2 markets across UEFA Champions League fixtures using get_event_odds
- Build a sports aggregator that lists live event counts per sport using list_sports with sport_type=live
- Compare Handicap and Total (Over/Under) lines across tournaments for a given sport
- Identify which tournaments have the most active events using the event_count field from list_tournaments
- Track pre-match odds for Nigerian football leagues by filtering list_sports with sport_type=prematch
- Populate a tournament selector UI by querying list_tournaments with a sport_id from list_sports results
- Alert on Double Chance market availability for specific matches using get_event_odds event objects
| 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 | 100 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.