The UFC API for developers ballers.
UFC fight cards and bout matchups — the two fighters, event date, and status for every bout — plus MMA moneyline odds, under one schema and one key. Bout results, fighter profiles, and win-loss records are coming soon.
1,000 req/day free (2,000 with GitHub). No credit card.
UFC · fight cards + bout matchups · results coming soon
Stats included
Every MMA stat field the API returns today — 21 in total, grouped by how they are produced. Each group carries its own freshness, because a sport is rarely uniformly current.
Per-game player stats
Coming soonThe schema exists but no rows have been loaded yet. No ingest timestamp on this table.
- Endpoint
- /v1/fight-cards
Fields (20)
Bout Order, Event Type, Judges’ Scorecards, Method of Victory, Finishing Round, Time of Finish, Winning Corner, Scheduled Rounds, Submission Type, Title Fight, Weight Class, Control Time (seconds), Corner, Knockdowns, Significant Strikes (body), Significant Strikes (head), Significant Strikes (leg), Takedowns Attempted, Takedowns Landed, Total Strikes
Team stats (per game)
Post-gameWritten after the game ends — not a live in-game feed. Last ingested 2026-08-30.
- Endpoint
- /v1/matches/:id/statistics
- Last updated
- 2026-08-30
Fields (1)
Score
Missing a stat?
We build what people actually ask for. If a field you need is not on this page, tell us — requests are how we decide what to add next.
What you can build
Event card pages
Render a full UFC card with its bout list from one call.
Matchup / schedule board
List each bout — the two fighters, date, and status — for an event.
Odds board
Pull MMA moneyline odds for the bouts on a card.
Endpoints
On the gateway at api.bigballsdata.com. Authenticate with the bearer token from /dashboard/keys.
| Method | Path | Returns | Plan |
|---|---|---|---|
| GET | /v1/fight-cards?sport=mma | UFC fight cards (events) | Free |
| GET | /v1/fight-cards/:id?sport=mma | Single card with its bout list | Free |
| GET | /v1/bouts/:id?sport=mma | Single bout matchup (fighters + status) | Free |
| GET | /v1/athletes/:id?sport=mma | Fighter profile | Coming soon |
| GET | /v1/athletes/:id/record?sport=mma | Win / loss / draw record | Coming soon |
Start on the free tier
100 requests per minute and 1,000 per day, free — the highest per-minute burst of any free sports API we checked. Burst is what matters when something asks several questions in a row and waits on each answer.
- Every sport and league we cover — the paid tiers add history depth and premium fields, not more leagues.
- Calls are counted one for one — no credit weighting, no markets-times-regions arithmetic.
- Link GitHub and the daily cap goes to 2,000.
- No credit card.
Or ask your AI tool directly
Connect your account to Claude, ChatGPT, Cursor, Perplexity or any other MCP-compatible tool and ask for MMA data in conversation — scores, standings, player stats and Elo ratings, with no API key to paste and no code to write. Your plan and limits carry over exactly as they do here.
Connect your AI tool →Integrate in a few lines
import { BigBallSportsClient } from '@bigballsdata/sdk';
const client = new BigBallSportsClient(process.env.BBS_API_KEY!);
const card = await client.fightCards.get(cardId, { sport: 'mma' });
for (const bout of card.bouts) {
console.log(bout.fighters.home.name, 'vs', bout.fighters.away.name, '-', bout.status);
}Free covers a real app. Scale when you need to.
1,000 req/day free (2,000 with GitHub). Production starts at $49/mo. Live WebSocket push on Pro+.
Frequently asked
- What UFC data is available today?
- UFC fight cards and bout matchups — the two fighters, event date, and status for every bout — plus MMA moneyline odds. Bout results (winner/method/round), fighter profiles, and win-loss records are not available yet; they are coming via a dedicated combat-results source.
- Are bout results or fighter records included?
- Not yet. Today a bout returns the matchup (both fighters) and its status — not the winner, method, round, or a win-loss record. Those are coming soon; we will not return a fabricated 0-0 result in the meantime.
- Do you have live or upcoming UFC odds?
- Yes for odds: MMA moneyline odds are available. The card and bout endpoints cover both completed and scheduled UFC events.
- Is the UFC API free?
- Yes. Fight cards and bout matchups on the free tier at 1,000 req/day (2,000 with GitHub), no credit card. MMA odds require the Edge plan ($149/mo) or higher.