# Ufcstats — 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 comprehensive UFC fight data including event results, fighter profiles, and detailed statistics like striking accuracy, takedown rates, and win-loss records. Search fighters, view fight cards, and explore fight history with method of victory information to analyze performance metrics and outcomes.

**Category:** Sports | **Website:** [http://www.ufcstats.com/statistics/events/completed](http://www.ufcstats.com/statistics/events/completed) | **Docs:** [parse.bot/marketplace/f0adc867-38a1-4f54-ae67-7fe6cb73accc/ufcstats-com-api](https://parse.bot/marketplace/f0adc867-38a1-4f54-ae67-7fe6cb73accc/ufcstats-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-ufcstats-com-api-f0adc867/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_event_details

Get the full fight card for a specific UFC event, including fighter names, results, knockdowns, significant strikes, takedowns, submission attempts, weight class, method of victory, round, and time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event ID hex string from get_events results (e.g. '9eedac48b497de5a'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ufcstats-com-api-f0adc867/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_events

Get a paginated list of completed UFC events with name, date, and location. Returns up to `limit` events per page. Paginate with `page`; total pages is included in the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of events to return per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ufcstats-com-api-f0adc867/get_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### get_fight_details

Get detailed statistics for a specific fight including totals (knockdowns, sig strikes, takedowns, control time), significant strikes by target (head, body, leg, distance, clinch, ground), and per-round breakdowns.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fight_id` | string | Yes | Fight ID hex string from get_event_details results (e.g. '7d0ce28ce8a77eb1'). |

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

### get_fighter_details

Get a fighter's full profile including career statistics (height, weight, reach, stance, DOB, striking accuracy, takedown accuracy, takedown defense, strikes landed/absorbed per minute, submission average) and complete fight history with results, opponents, and methods of victory. Returns stale_input with kind 'input_not_found' if the fighter ID does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fighter_id` | string | Yes | Fighter ID hex string from search_fighters or get_event_details results (e.g. 'f4c49976c75c5ab2'). |

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

### search_fighters

Search for UFC fighters by name. Returns matching fighters with basic info including height, weight, reach, stance, and win-loss-draw record.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Fighter name to search for (first name, last name, or partial match). |

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