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

# Sport Shorthand Routes

> Convenience routes that use sport slugs instead of numeric IDs

V5 ships sport-slug shortcuts for the two most-used endpoints. The response shape is identical to the canonical endpoints.

## Prematch top events

```
GET /api/v1/{sport}/top
GET /api/v1/{sport}/top?count=10
```

Equivalent to [`/api/v1/events/top?sport={id}`](/api-reference/v5-1xbet/top-events).

## Live events

```
GET /api/v1/{sport}/live
```

Equivalent to [`/api/v1/live/events?sport={id}`](/api-reference/v5-1xbet/live).

## Examples

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/football/top?count=10"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/tennis/live"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/cricket/top"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/ice-hockey/live"
```

## Supported slugs

`football`, `soccer`, `hockey`, `ice-hockey`, `basketball`, `tennis`, `baseball`, `volleyball`, `rugby`, `handball`, `boxing`, `table-tennis`, `american-football`, `futsal`, `darts`, `beach-soccer`, `f1`, `formula-1`, `australian-rules`, `beach-volleyball`, `snooker`, `esports`, `golf`, `cricket`, `ufc`.

<Note>For any sport not in the slug list, use the numeric `?sport={id}` form on the canonical endpoints.</Note>