# Statleaders Ufc — 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.

> Track and compare UFC fighter performance with access to ranked leaderboards for career achievements, individual fight statistics, round-by-round data, and event records. Search fighter profiles and fight details to analyze comprehensive combat statistics and record book information across the UFC's history.

**Category:** Sports | **Website:** [statleaders.ufc.com/](https://statleaders.ufc.com/) | **Docs:** [parse.bot/marketplace/e28e943e-808a-496e-af09-004833d1c04c/statleaders-ufc-com-api](https://parse.bot/marketplace/e28e943e-808a-496e-af09-004833d1c04c/statleaders-ufc-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_career_stats_leaders

Retrieve career-level stat leaderboards including Total Fights, Wins, Finishes, KO/TKO Wins, Submission Wins, Decision Wins, Win Streak, Title Fight Wins, Striking, Grappling categories. Returns top 3 records per category. Filterable by country, weight class, and fighter status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter by country code (e.g., 'US', 'BR', 'IE'). |
| `fighter_status` | string | No | Fighter status filter. Accepted values: '0' (all), '1' (active), '2' (retired). |
| `weight_class` | string | No | Filter by weight class slug as used on statleaders.ufc.com (e.g., 'Flyweight', 'Bantamweight', 'Featherweight', 'Lightweight', 'Welterweight', 'Middleweight', 'Light_Heavyweight', 'Heavyweight'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_career_stats_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","fighter_status":"<string>","weight_class":"<string>"}'
```

### get_event_stat_leaders

Retrieve event-level record leaderboards including KO/TKO Wins, Submission Wins, Shortest/Longest Event, and more. Returns top 3 records per category. No filters available.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_event_stat_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_fight_combined_stat_leaders

Retrieve combined two-fighter fight record leaderboards (both fighters' stats summed). Returns top 3 records per category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `weight_class` | string | No | Filter by weight class slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_fight_combined_stat_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"weight_class":"<string>"}'
```

### get_fight_details

Get detailed fight info by fight UUID. Use search_fights to find the UUID first. Returns a flat fight object with key attributes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Fight UUID from search_fights results (e.g., '4ac965ae-a3b5-4fab-8b56-caabf3564f39'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_fight_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_fight_stat_leaders

Retrieve single-fight record leaderboards including Fastest Finish, Knockdowns, Significant Strikes, Takedowns, and more. Returns top 3 records per category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter by country code (e.g., 'US', 'BR'). |
| `weight_class` | string | No | Filter by weight class slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_fight_stat_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","weight_class":"<string>"}'
```

### get_fighter_details

Get detailed fighter bio and statistics by athlete UUID. Use search_fighters to find the UUID first. Returns a flat fighter object with key attributes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Fighter UUID from search_fighters results (e.g., 'f48cc930-1c99-4c3c-bd24-05898cd9664c'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_fighter_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_round_combined_stat_leaders

Retrieve combined two-fighter round record leaderboards (both fighters' stats summed per round). Returns top 3 records per category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `weight_class` | string | No | Filter by weight class slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_round_combined_stat_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"weight_class":"<string>"}'
```

### get_round_stat_leaders

Retrieve single-round record leaderboards. Returns top 3 records per category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Filter by country code (e.g., 'US', 'BR'). |
| `weight_class` | string | No | Filter by weight class slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/get_round_stat_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","weight_class":"<string>"}'
```

### search_fighters

Search for fighters by name using the UFC JSON:API. Uses exact title match against the fighter's full name. Returns a flat array of fighter objects with key attributes extracted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Fighter name to search for (e.g., 'Conor McGregor', 'Jon Jones'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/search_fighters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```

### search_fights

Search for fights by fighter name or title keyword using the UFC JSON:API. Uses partial (CONTAINS) matching on fight titles formatted as 'Fighter A vs Fighter B'. Returns a flat array of fight objects.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `title` | string | Yes | Search term to match in fight titles (e.g., 'McGregor' or 'Poirier vs McGregor'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-statleaders-ufc-com-api-e28e943e/search_fights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"<string>"}'
```