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

> Browse OKTAGON MMA fighters with pagination and optional weight-class filtering, then fetch detailed fighter profiles and their full fight history.

**Category:** Sports | **Website:** [oktagonmma.com/](https://oktagonmma.com/) | **Docs:** [parse.bot/marketplace/becc89e1-d596-4b6b-b8e5-d7d239253d99/oktagonmma-com-api](https://parse.bot/marketplace/becc89e1-d596-4b6b-b8e5-d7d239253d99/oktagonmma-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-oktagonmma-com-api-becc89e1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_fighters

Get all fighters by iterating through all pages. Returns the complete list of all OKTAGON fighters with their basic information. This may take several seconds due to internal pagination over the full roster.

**Estimated cost:** Metered

_No parameters required._

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

### get_fighter

Get detailed profile for a specific fighter by ID. Returns full fighter details including description, rankings, images, and links. Raises input_not_found if the fighter ID does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fighter_id` | integer | Yes | OKTAGON fighter ID (from list_fighters results). |

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

### get_fighter_fight_history

Get fight history for a specific fighter. Returns past fights with results, opponents, event details, and fight statistics ordered by most recent first. Some fighters may have no recorded OKTAGON fights, in which case an empty fights array is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fighter_id` | integer | Yes | OKTAGON fighter ID (from list_fighters results). |
| `limit` | integer | No | Maximum number of fights to return. |

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

### list_fighters

List fighters with pagination and optional weight class filtering. Returns basic fighter information including name, record, weight class, nationality, and image. The API returns fighters ordered by most recently added. Uses skip/limit offset pagination; each call returns one page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of fighters to return per page (max 100). |
| `skip` | integer | No | Number of fighters to skip for pagination. |
| `weight_class_id` | integer | No | Filter by weight class ID. Known values: 1=Welterweight, 2=Middleweight, 3=Light Heavyweight, 4=Lightweight, 5=Heavyweight, 6=Bantamweight. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oktagonmma-com-api-becc89e1/list_fighters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","skip":"<integer>","weight_class_id":"<integer>"}'
```