The free UFC API, limits included.
Get a free key and pull real UFC fighters, cards, results, and round stats today: 500 requests a month, 10 requests a minute, 30 days of in-depth history, and live data on a 60-second delay.
- 500 requests / month
- 10 requests / minute
- All 7 games on REST
{ "success": true, "data": { "slug": "jon-jones", "name": "Jon Jones", "division": "Heavyweight", "recordText": "28-1-0 (W-L-D)", "stats": { "strikingAccuracy": "0.59", "takedownDefense": "0.95", "sigStrikesLandedPerMin": "4.38" } }}Seamless Integration with our MCP Server
Give Claude, Cursor, and Grok the UFC card. One command writes the MCP config, agents call live and card tools instead of inventing fight IDs, and your key stays on your machine.
MCPInstall the Cito MCP server
What a free key gets you
Enough real UFC data to build and prove a prototype, with every limit stated up front so nothing surprises you later.
Fighters, cards, and results
Profiles, records, upcoming and past events, every bout on a card, and each result's winner, method, and round.
Full fight histories
A fighter's complete record of results, methods, and opponents is available for every period on every plan.
30 days of in-depth stats
Bout and round stat tables for events in the last 30 days. Starter extends that to 90 days and Pro to the full archive.
Live data on a 60-second delay
Follow a live card on REST a minute behind. Real-time data and WebSockets start on Pro.
Clear limits, clear errors
10 requests a minute and 500 a month. A limit response names your plan, what you hit, and when it resets.
What stays paid
Odds and betting markets, WebSockets, and commercial use are not part of Free. Starter adds commercial use from $15.
Endpoints you can ship with
Every group below works on a free key. Start with events, open a card, then pull bouts and stats.
Live data
Subscribe over WebSocket for pushed bout updates, use the SSE stream for one-way clients, or poll the live card on fight night.
- GET
/api/v1/ufc/liveLive card overview: active bouts, clocks, lagSeconds, recommendedPollSeconds.
- GET
/api/v1/ufc/live/eventsFight-night events currently tracked by the live worker.
- GET
/api/v1/ufc/live/{boutId}One live bout: clock, fighters, and stats when available.
- GET
/api/v1/ufc/live/{boutId}/stateCompact live state for polling clients.
- GET
/api/v1/ufc/live/wsWebSocket push: subscribe to bout:{boutId} or event:{eventSlug} rooms.
- GET
/api/v1/ufc/live/streamSSE push feed, filterable by boutId and/or eventSlug.
- GET
/api/v1/ufc/live/healthLive worker health and heartbeat lag.
Events & cards
List cards, open one event by its slug (for example cryptocom-ufc-331), and pull every bout on it.
- GET
/api/v1/ufc/events?page=1&limit=50Paginated events with clean slugs and stable IDs.
- GET
/api/v1/ufc/events/upcomingUpcoming fight cards.
- GET
/api/v1/ufc/events/recentRecently completed events.
- GET
/api/v1/ufc/events/{eventIdOrSlug}Event detail by slug or stable data ID.
- GET
/api/v1/ufc/events/{eventIdOrSlug}/boutsAll bouts on one card, including corner fighters.
Bouts & results
Results for any fight: who won, how, when it ended, and the event context around it.
- GET
/api/v1/ufc/bouts?hasStats=truePaginated bout list with optional stat rows.
- GET
/api/v1/ufc/bouts/{boutId}Fighters, result, method, round, time, referee, weight class.
Fight stats
Significant strikes, takedowns, control time, and knockdowns as bout totals or per round, with head/body/leg and position splits.
- GET
/api/v1/ufc/bouts/{boutId}/statsBout-level fighter stat totals, or one round with ?round=1.
- GET
/api/v1/ufc/bouts/{boutId}/roundsRound-by-round fighter stat rows for one bout.
- GET
/api/v1/ufc/events/{eventIdOrSlug}/statsFight stats for a whole card, filterable by round.
Fighters
Build profile pages and matchup tools: record, bio, career stat aggregates, and every past fight.
- GET
/api/v1/ufc/search?q={name}Search fighters, events, bouts, and divisions.
- GET
/api/v1/ufc/fighters?page=1&limit=50Paginated fighter directory.
- GET
/api/v1/ufc/fighters/{slug}Profile, bio, record, rankings, and stat summary.
- GET
/api/v1/ufc/fighters/{slug}/statsStriking, grappling, accuracy, defense, and win-method stats.
- GET
/api/v1/ufc/fighters/{slug}/fightsFight history for one fighter.
Rankings
Algorithmic Meta rankings and media-panel rankings by division, as separate endpoints.
- GET
/api/v1/ufc/rankingsMeta UFC Rankings grouped by division.
- GET
/api/v1/ufc/rankings/meta/{division}Meta rankings for one division, such as lightweight.
- GET
/api/v1/ufc/rankings/mediaMedia-panel rankings grouped by division.
- GET
/api/v1/ufc/rankings/media/{division}Media-panel rankings for one division.
Odds
Card and fight odds grouped by market, bookmaker, and outcome, with sportsbook filters.
- GET
/api/v1/ufc/events/{eventIdOrSlug}/odds?bookmaker=allAll odds for one card, grouped by fight and market.
- GET
/api/v1/ufc/fights/{boutId}/odds?bookmaker=draftkingsOdds for one fight, filterable by sportsbook.
FAQs
Limits, history, commercial use, and upgrades
Can't find what you're looking for? Contact our customer support team
Start with these
The pages most free keys hit first, and where to go when you outgrow Free.
- UFC APIFighters, cards, results, rankings, and round-by-round stats in one API.
- UFC schedule APIUpcoming events with dates, locations, and time zones.
- UFC fight card APIEvery bout on a card, with corners and results.
- UFC stats APICareer striking, grappling, and defense numbers per fighter.
- UFC odds APIMoneylines and props, available from Pro.
- Compare plansFree, Starter, Pro, and Scale side by side.
Start free, build fight cards
No sales call. Create a key, hit your first UFC endpoint in a minute, and upgrade only when the app is real.