Skip to main content

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

sport
number
default:"1"
Sport ID.
count
number
default:"50"
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.
Cache TTL: 30 seconds.
Last modified on June 29, 2026