# Olympics — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 Olympic Games results, medal tables, and athlete profiles to track performances across disciplines and events. Search featured athletes, view competition outcomes, and stay updated on medal standings from the official Olympics source.

**Category:** Sports | **Website:** [olympics.com/](https://olympics.com/) | **Docs:** [parse.bot/marketplace/7d5fca40-aeac-47f6-b752-aaa7b472e57d/olympics-com-api](https://parse.bot/marketplace/7d5fca40-aeac-47f6-b752-aaa7b472e57d/olympics-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/`
**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 athlete profile

Get detailed profile of a specific Olympic athlete including biography, medal counts by type, disciplines, social media links, and full Olympic results history with placements per event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_slug` | string | Yes | Athlete slug identifier (e.g. 'usain-bolt', 'simone-biles', 'leon-marchand'). Obtain from search_featured_athletes endpoint. |

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

### Get event results

Get medal winners for all events in a discipline at a specific completed Olympic Games. Returns gold, silver, and bronze medalists with athlete names, countries, and rankings for each event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `discipline_slug` | string | Yes | Discipline slug (e.g. 'athletics', 'swimming'). Obtain from list_disciplines endpoint. |
| `games_slug` | string | Yes | Olympic Games slug (e.g. 'paris-2024', 'tokyo-2020') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/get-event-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"discipline_slug":"<string>","games_slug":"<string>"}'
```

### Get medal table

Get the medal standings (country rankings) for a specific completed Olympic Games edition. Returns countries ranked by gold, silver, and bronze medal counts with totals.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `games_slug` | string | Yes | Olympic Games slug (e.g. 'paris-2024', 'tokyo-2020') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/get-medal-table \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"games_slug":"<string>"}'
```

### List disciplines

List all disciplines (sports) for a specific completed Olympic Games edition. Returns discipline slugs and titles that can be used to fetch events or results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `games_slug` | string | No | Olympic Games slug identifier (e.g. 'paris-2024', 'tokyo-2020', 'beijing-2022'). Must be a completed games edition with medal data. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/list-disciplines \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"games_slug":"<string>"}'
```

### List events

List all events for a specific discipline in a completed Olympic Games edition. Returns event titles, slugs, and gender categories. Requires both the games slug and discipline slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `discipline_slug` | string | Yes | Discipline slug (e.g. 'athletics', 'swimming'). Obtain from list_disciplines endpoint. |
| `games_slug` | string | Yes | Olympic Games slug (e.g. 'paris-2024', 'tokyo-2020') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/list-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"discipline_slug":"<string>","games_slug":"<string>"}'
```

### List olympic games

List all Olympic Games editions (Summer, Winter, Youth) with their slug identifiers, years, and seasons. Returns both upcoming and past games. Use the slug to construct a Game and access its disciplines or medal table.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/list-olympic-games \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search featured athletes

Get the curated list of featured/highlighted Olympic athletes as displayed on the Olympics athletes page. Returns notable athletes with basic info including name, country, discipline, and slug for profile lookup.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/olympics/search-featured-athletes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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