# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/oktagonmma/`
**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 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/credits/oktagonmma/get-all-fighters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/oktagonmma/get-fighter \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/oktagonmma/get-fighter-fight-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/oktagonmma/list-fighters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","skip":"<integer>","weight_class_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.