# Sports — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access football league standings, match results, player statistics, and upcoming fixtures from Sports.ru. Retrieve tournament tables, top scorers, detailed match information, and individual player profiles across major football leagues.

**Category:** Sports | **Website:** [sports.ru/](https://sports.ru/) | **Docs:** [parse.bot/marketplace/4b6fbd7a-4014-4ade-8bb0-9b530353e849/sports-ru-api](https://parse.bot/marketplace/4b6fbd7a-4014-4ade-8bb0-9b530353e849/sports-ru-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/sports-ru/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get league matches

Returns recently completed or upcoming matches for a football tournament, grouped by date. Each match includes team info, scores (for completed), start time, and a base_url slug usable with get_match_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Match status filter. Accepted values: 'last' for past matches, 'future' for upcoming fixtures. |
| `tournament_id` | integer | Yes | ID of the tournament from get_tournament_list results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sports-ru/get-league-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>","tournament_id":"<integer>"}'
```

### Get league standings

Returns the standings table for a specific football tournament. Each entry includes team place, points (score), matches played, and a color code indicating qualification zone. Results are grouped (single group for league formats).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament_id` | integer | Yes | ID of the tournament from get_tournament_list results (e.g., 31 for RPL, 52 for EPL, 49 for La Liga). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sports-ru/get-league-standings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"tournament_id":"<integer>"}'
```

### Get league top scorers

Returns top scorers, assist leaders, and yellow card leaders for a football tournament. Players are grouped by stat category (bombardiers, assists, yellow_cards) with player name, team, and stat values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament_id` | integer | Yes | ID of the tournament from get_tournament_list results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sports-ru/get-league-top-scorers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"tournament_id":"<integer>"}'
```

### Get match details

Returns detailed match information including header info (teams, tournament, round), match statistics (possession, shots, cards), events (goals, cards with minute and player), and lineups (starting XI and substitutes). Match slug is obtained from get_league_matches base_url field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_slug` | string | Yes | Slug of the match from get_league_matches results base_url field (e.g., 'brighton-vs-mu', 'chelsea-vs-sunderland'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sports-ru/get-match-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"match_slug":"<string>"}'
```

### Get player profile

Returns a player's biographical data (born, citizenship, club, position, height/weight) and career statistics table by season (matches, goals, assists, cards, minutes). Player slug is obtained from tag_url fields in other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_slug` | string | Yes | Slug of the player as used on sports.ru (e.g., 'erling-haland', 'bruno-fernandes', 'salah'). Found in tag_url field of player objects from other endpoints. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sports-ru/get-player-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"player_slug":"<string>"}'
```

### Get tournament list

Retrieves the list of football tournaments available on sports.ru. Only football (sport_id=208) returns data; other sport IDs yield empty results. Each tournament has an id usable in other endpoints and a localized Russian name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sport_id` | integer | No | ID of the sport. Only Football (208) is supported and returns data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sports-ru/get-tournament-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sport_id":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.