GET /api/v1/events/top
Returns the top prematch events for a sport, sorted by start time. Each event includes pre-parsed main odds (1X2, Double Chance, Totals, BTTS, Draw No Bet, Handicap).
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.sportsapipro.com/v5/events/top?sport=1&count=50"
Query Parameters
Max number of events to return.
Response
{
"data": [
{
"id": 716611045,
"sportId": 1,
"leagueId": 2708736,
"leagueName": "World Cup 2026",
"homeTeam": "Spain",
"awayTeam": "Saudi Arabia",
"homeTeamId": 13299,
"awayTeamId": 29155,
"homeImage": "https://images.sportsapipro.com/team/cb151152db93a8293a4bead299416b4c.png",
"awayImage": "https://images.sportsapipro.com/team/29155.png",
"startTime": 1782057600,
"startTimeISO": "2026-06-21T16:00:00.000Z",
"marketCount": 1270,
"winProbability": { "P1": 0.89, "P2": 0.03, "PX": 0.08 },
"venue": "Mercedes-Benz (Atlanta)",
"round": "Group Stage. Group H. Round 2",
"odds": {
"1x2": { "home": 1.107, "draw": 11.8, "away": 36 },
"double_chance": { "1X": 1.001, "X2": 1.063, "12": 8.1 },
"totals": { "over_3.5": 1.93 },
"btts": { "yes": 1.444, "no": null },
"draw_no_bet": { "home": 1.375, "away": null },
"handicap": [
{ "type": "home", "line": -2.5, "odds": 1.782 },
{ "type": "away", "line": 2.5, "odds": 2.104 }
]
}
}
],
"sport": "football",
"count": 10
}
See Data Models → Event Object for the full field reference.