Name: UFC Stats API: UFC Fighter Stats, Events & Fight Results
Brand: proapi
SKU: api-proapi-ufc-stats
Availability: InStock
Author: API Market

JarX8

# UFC Stats API: Fighter Stats, Events & Fights

## Overview

The UFC Stats API gives you mixed martial arts data from ufcstats.com through 8 GET endpoints grouped into events, fights and fighters. Event endpoints list upcoming and completed events, search events by name and return a full fight card with results for one event. Each fight on a card has an ID you pass to /v1/fight/details for the method, round, time, referee and per round striking and grappling stats. Fighter endpoints search by name or nickname, list fighters by first letter and return a profile with record, physical data, career averages and fight history.

It suits MMA apps and fan sites, fantasy MMA and betting research tools, journalists and content creators, and analysts building fighter models. Responses are JSON with hex string IDs for events, fights and fighters, wins, losses, draws and no contests, height, weight and reach in both imperial and metric units, career rates such as significant strikes landed per minute, striking accuracy and takedown defence, and fight stats split by target (head, body, leg) and position (distance, clinch, ground).

## Features

*   **8 endpoints**: Event, fight and fighter endpoints, all plain GET requests with query parameters.
*   **Events and fight cards**: Upcoming and completed event lists, event search, and full cards with winner, weight class, method, round and time.
*   **Round by round fight stats**: Knockdowns, significant and total strikes, takedowns, submission attempts, reversals and control time per fighter and per round.
*   **Fighter profiles**: Record, nickname, height, weight, reach, stance, age, career averages and a list of past fights with opponent and result.
*   **Search and A to Z lists**: Search events and fighters by name, or list all fighters whose name starts with a given letter.
*   **ID chaining**: Event cards return fight and fighter IDs, and fighter histories return fight and event IDs, so one call leads to the next.
*   **Data source**: Publicly visible data from ufcstats.com, returned as JSON.
*   **Rate limit**: 10 requests/second on the free trial, 300 on pay-as-you-go.

## Use Cases

*   **MMA apps and fan sites**: Show upcoming cards, results for each bout and fighter profile pages.
*   **Fight prediction models**: Feed career averages and round by round strike and takedown data into a model.
*   **Fantasy MMA scoring**: Score fights from knockdowns, significant strikes, takedowns and finish method.
*   **Tale of the tape graphics**: Compare height, reach, stance, age and record for two fighters before an event.
*   **Journalism and research**: Pull a fighter's full fight history with opponents, methods and rounds for articles.
*   **Event recap bots**: Post results for every bout on a card once an event is completed.

## Pricing

| Plan | Price | What you get | Rate limit |
|---|---|---|---|
| Free | $0 | 7-day trial with 100 API calls | 10 requests/second |
| PAYG | No monthly fee | US$0.001 per successful call, paid from your API.market wallet | 300 requests/second |

Only successful (2xx) responses count. A lookup for something that does not exist returns `404` and is not billed.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/proapi/ufc-stats
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search events

Returns events matching a search query (event name).

**Method:** `GET`

**Endpoint:** `/v1/event/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `query` | query | Example: `Horiguchi`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/event/search?query=Horiguchi" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
[
  {
    "id": "c8661e204c66f325",
    "name": "UFC Fight Night: Kape vs. Horiguchi",
    "date": "2026-06-20",
    "location": "Las Vegas, Nevada, USA"
  },
  {
    "id": "997b4f52f76a0b53",
    "name": "UFC 186: Johnson vs Horiguchi",
    "date": "2015-04-25",
    "location": "Montreal, Quebec, Canada"
  }
]
```

#### 2. Get event details

Returns details and the full fight card for an event.

**Method:** `GET`

**Endpoint:** `/v1/event/details`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `id` | query | Example: `e60d773a0a42048a`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/event/details?id=e60d773a0a42048a" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "id": "e60d773a0a42048a",
  "name": "UFC Fight Night: Sterling vs. Zalal",
  "date": "2026-04-25",
  "location": "Las Vegas, Nevada, USA",
  "fights": [
    {
      "id": "f524e42c36028de0",
      "result": "win",
      "winner": "cb696ebfb6598724",
      "weightClass": "Featherweight",
      "method": "U-DEC",
      "methodDetail": null,
      "round": "5",
      "time": "5:00",
      "fighters": [
        {
          "id": "cb696ebfb6598724",
          "name": "Aljamain Sterling",
          "kd": "0",
          "str": "46",
          "td": "6",
          "sub": "1"
        },
        {
          "id": "52c2ae6d2f2d2613",
          "name": "Youssef Zalal",
          "kd": "0",
          "str": "35",
          "td": "0",
          "sub": "1"
        }
      ]
    },
    {
      "id": "cb745968bd16bf56",
      "result": "win",
      "winner": "f9ab66e67240db7b",
      "weightClass": "Women's Bantamweight",
      "method": "U-DEC",
      "methodDetail": null,
      "round": "3",
      "time": "5:00",
      "fighters": [
        {
          "id": "f9ab66e67240db7b",
          "name": "Joselyne Edwards",
          "kd": "0",
          "str": "70",
          "td": "0",
          "sub": "0"
        },
        {
          "id": "d3f5d33d61cd00c9",
          "name": "Norma Dumont",
          "kd": "0",
          "str": "51",
          "td": "0",
          "sub": "0"
        }
      ]
    }
  ]
}
```

#### 3. Get completed events

Returns the list of completed events.

**Method:** `GET`

**Endpoint:** `/v1/event/completed`

**Parameters:**

None.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/event/completed" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Response:** the image file itself, not JSON.

#### 4. Get upcoming events

Returns the list of upcoming events.

**Method:** `GET`

**Endpoint:** `/v1/event/upcoming`

**Parameters:**

None.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/event/upcoming" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": "7f98d9d5a10fa25c",
    "name": "UFC Fight Night: Allen vs. Duncan",
    "date": "2026-10-10",
    "location": "Las Vegas, Nevada, USA"
  },
  {
    "id": "55e94a9b525dcf45",
    "name": "UFC Fight Night: Buckley vs. Malott",
    "date": "2026-10-17",
    "location": "Edmonton, Alberta, Canada"
  }
]
```

#### 5. Get fight details

Returns details, result and round-by-round statistics for a fight.

**Method:** `GET`

**Endpoint:** `/v1/fight/details`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `id` | query | Example: `c27e33ee8ef53866`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/fight/details?id=c27e33ee8ef53866" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "id": "c27e33ee8ef53866",
  "event": {
    "id": "ccd58ff71e260ed5",
    "name": "UFC 291: Poirier vs. Gaethje 2"
  },
  "bout": "Lightweight Bout",
  "result": "win",
  "winner": "9e8f6c728eb01124",
  "method": "KO/TKO",
  "methodDetail": "Kick to Head At Distance",
  "round": "2",
  "time": "1:00",
  "timeFormat": "5 Rnd (5-5-5-5-5)"
}
```

#### 6. Search fighters

Returns fighters matching a search query (name or nickname).

**Method:** `GET`

**Endpoint:** `/v1/fighter/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `query` | query | Example: `Notorious`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/fighter/search?query=Notorious" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": "b301292b1bc92bdb",
    "name": "Roshan Mainam",
    "nickname": "The Indian Notorious",
    "physical": {
      "height": null,
      "heightIn": null,
      "heightCm": null,
      "weightLbs": 135,
      "weightKg": 61,
      "reachIn": null,
      "reachCm": null,
      "stance": null
    },
    "record": {
      "wins": 6,
      "losses": 3,
      "draws": 0
    },
    "belt": false
  },
  {
    "id": "f4c49976c75c5ab2",
    "name": "Conor McGregor",
    "nickname": "The Notorious",
    "physical": {
      "height": "5' 9\"",
      "heightIn": 69,
      "heightCm": 175,
      "weightLbs": 155,
      "weightKg": 70,
      "reachIn": 74,
      "reachCm": 188,
      "stance": "Southpaw"
    },
    "record": {
      "wins": 22,
      "losses": 7,
      "draws": 0
    },
    "belt": false
  }
]
```

#### 7. Get fighters list

Returns the alphabetical list of fighters for a given starting letter.

**Method:** `GET`

**Endpoint:** `/v1/fighter/list`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `char` | query | Example: `a`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/fighter/list?char=a" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
[
  {
    "id": "93fe7332d16c6ad9",
    "name": "Tom Aaron",
    "nickname": null,
    "physical": {
      "height": null,
      "heightIn": null,
      "heightCm": null,
      "weightLbs": 155,
      "weightKg": 70,
      "reachIn": null,
      "reachCm": null,
      "stance": null
    },
    "record": {
      "wins": 5,
      "losses": 3,
      "draws": 0
    },
    "belt": false
  },
  {
    "id": "15df64c02b6b0fde",
    "name": "Danny Abbadi",
    "nickname": "The Assassin",
    "physical": {
      "height": "5' 11\"",
      "heightIn": 71,
      "heightCm": 180,
      "weightLbs": 155,
      "weightKg": 70,
      "reachIn": null,
      "reachCm": null,
      "stance": "Orthodox"
    },
    "record": {
      "wins": 4,
      "losses": 6,
      "draws": 0
    },
    "belt": false
  }
]
```

#### 8. Get fighter details

Returns details, career statistics and fight history for a fighter.

**Method:** `GET`

**Endpoint:** `/v1/fighter/details`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `id` | query | Example: `f4c49976c75c5ab2`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/proapi/ufc-stats/v1/fighter/details?id=f4c49976c75c5ab2" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "id": "f4c49976c75c5ab2",
  "name": "Conor McGregor",
  "nickname": "The Notorious",
  "record": {
    "wins": 22,
    "losses": 7,
    "draws": 0,
    "noContests": 0
  },
  "physical": {
    "height": "5' 9\"",
    "heightIn": 69,
    "heightCm": 175,
    "weightLbs": 155,
    "weightKg": 70,
    "reachIn": 74,
    "reachCm": 188,
    "stance": "Southpaw",
    "birthday": "1988-07-14",
    "age": 38
  },
  "career": {
    "slpm": "5.27",
    "strAcc": "49%",
    "sapm": "4.71",
    "strDef": "53%",
    "tdAvg": "0.66",
    "tdAcc": "55%",
    "tdDef": "66%",
    "subAvg": "0.1"
  },
  "fights": [
    {
      "result": "loss",
      "id": "989760fa75321d69",
      "opponent": {
        "id": "150ff4cc642270b9",
        "name": "Max Holloway"
      },
      "event": {
        "id": "fccb0fee256b7b4d",
        "name": "UFC 329: McGregor vs. Holloway 2",
        "date": "2026-07-11"
      },
      "kd": {
        "fighter": "0",
        "opponent": "0"
      },
      "str": {
        "fighter": "0",
        "opponent": "12"
      },
      "td": {
        "fighter": "0",
        "opponent": "0"
      },
      "sub": {
        "fighter": "0",
        "opponent": "0"
      },
      "method": "KO/TKO",
      "methodDetail": null,
      "round": "1",
      "time": "1:09"
    }
  ]
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the data is in the response body. |
| 400 | Bad Request | A required parameter is missing or invalid, or the `x-api-market-key` header is missing. The body explains which. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your API.market subscription does not include this endpoint. |
| 404 | Not Found | The requested item does not exist (`{"error":true,"message":"Not found"}`), or there is nothing to return right now. Not billed. |
| 429 | Too Many Requests | You went over 10 requests/second (free trial) or 300 requests/second (PAYG), or used all 100 trial calls. |
| 500 | Internal Server Error | Something failed while fetching the data. Retry after a short delay. |
| 503 | Service Unavailable | The data source is temporarily unavailable. Retry later. |

## Rate Limits

The free trial allows 10 requests per second and 100 API calls over 7 days. The PAYG plan allows up to 300 requests per second with no monthly quota. Requests above the limit return `429 Too Many Requests`; throttle your client, back off before retrying, and honour any `Retry-After` header.

## FAQ

**Is this the official UFC Stats API?**

No. This is an independent API that returns publicly visible data from ufcstats.com. It is not an official UFC or UFC Stats API and is not affiliated with or endorsed by either.

**Is there a free UFC Stats API?**

Yes, there is a free trial: the Free plan runs for 7 days and includes 100 API calls at up to 10 requests per second.

**How much does the UFC Stats API cost?**

After the trial, the pay-as-you-go plan has no monthly fee and costs US$0.001 per successful call, paid from your API.market wallet, with up to 300 requests per second.

**How do I find event, fight and fighter IDs?**

Use /v1/event/upcoming, /v1/event/completed or /v1/event/search for event IDs, then /v1/event/details for the fight IDs on that card. For fighters use /v1/fighter/search or /v1/fighter/list with a starting letter.

**What happens if an ID is not found?**

The API returns 404 with {"error":true,"message":"Not found"} and the call is not billed. Only successful 2xx responses count against your quota.

**Which career stats are included for a fighter?**

Significant strikes landed and absorbed per minute, striking accuracy and defence, takedown average, accuracy and defence, and submission average, plus the win, loss, draw and no contest record.

**Does it include round by round stats?**

Yes. /v1/fight/details returns fight totals and a rounds array with per fighter stats for each round, including strikes by target and position.

**How do I authenticate?**

Send your key in the x-api-market-key header to https://prod.api.market/api/v1/proapi/ufc-stats.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


UFC Stats API for fighter records, career stats, event cards and round by round fight stats from ufcstats.com in JSON. Free trial included.

UFC Stats API: UFC Fighter Stats, Events & Fight Results