> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Top Events (Prematch)

> Top prematch events for a sport, sorted by start time, with main odds

## 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).

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/events/top?sport=1&count=50"
```

### Query Parameters

<ParamField query="sport" type="number" default="1">Sport ID.</ParamField>
<ParamField query="count" type="number" default="50">Max number of events to return.</ParamField>

### Response

```json theme={null}
{
  "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](/api-reference/v5-1xbet/models#event-object-prematch) for the full field reference.

<Note>**Cache TTL:** 30 seconds.</Note>