{ "openapi": "3.1.0", "info": { "title": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3+gw.2026-09-07.1", "summary": "Normalized UFC data plus proprietary PropBetEdge Fight DNA, delivered through one developer API.", "description": "**UFC data built for developers.** Normalized events, fighters, cards, results and round-level statistics, plus proprietary PropBetEdge Fight DNA and Matchup DNA.\n\nThis is the commercial distribution contract for the PropTechUSA UFC Intelligence API. It exposes a plan-gated subset of the canonical PropBetEdge UFC API (data-contract version `2026-09-06.3`, Fight DNA definition version 1). Response bodies are identical to the canonical API; the gateway adds authentication, entitlement, quota and rate-limit headers only.\n\n### Authentication\n`Authorization: Bearer pt_ufc_live_…` (or `X-API-Key`). Keys are issued per plan; the secret is shown once.\n\n### Plans\n| Plan | Price | Requests / month | Requests / minute | Unlocks |\n| --- | --- | --- | --- | --- |\n| **Developer** | $79/mo | 25,000 | 60 | Core UFC data |\n| **Pro** | $199/mo | 100,000 | 180 | Fighter intelligence |\n| **Ultra** | $499/mo | 500,000 | 600 | Matchup intelligence |\n| **Scale** | $1499/mo | 2,000,000 | 1200 | Production infrastructure |\n| **Enterprise** | Let's talk | custom | custom | Custom |\n\nEvery operation below carries `x-plan` (minimum plan) and `x-origin` (SOURCE_FACT, PBE_DERIVED, LICENSED, EDITORIAL, MEDIA, THIRD_PARTY_LINK).\n\n### Origin labels\n- **SOURCE_FACT** — normalized facts from ESPN / UFC Stats / ufc.com (events, results, strike counts, official rankings snapshot).\n- **PBE_DERIVED** — computed by the PropBetEdge Fight DNA builder from normalized fight history. Every derived value is a `MetricObject` carrying sample size, provenance, confidence, as-of date and definition version. Not official UFC statistics.\n- **LICENSED** — reserved for licensed enrichment (position profiles); explicitly unavailable until a licensed source exists.\n- **EDITORIAL** — PropBetEdge newsroom content. **MEDIA** — image metadata with license and attribution (render the credit). **THIRD_PARTY_LINK** — ids and official URLs only; nothing is rehosted.\n\n### Truthful nulls\nMissing data is `null` or an explicit `404 dna_not_available` / `503 *_not_available`. The API never returns fabricated zeroes, odds, picks or probabilities.\n\nPropTechUSA and PropBetEdge are independent products and are not affiliated with, endorsed by, or sponsored by UFC, Zuffa LLC, TKO Group, ESPN or any sportsbook.", "termsOfService": "https://ufc.proptechusa.ai/legal", "contact": { "name": "PropTechUSA", "url": "https://proptechusa.ai", "email": "sales@proptechusa.ai" }, "x-upstream": { "repository": "LHBUSA/UFC", "branch": "ufc-fight-dna-v1", "commit": "1f43e64658b22eaaff576a365d62a37dedc374ce", "api_version": "2026-09-06.3", "fight_dna_definition_version": 1 } }, "servers": [ { "url": "https://ufc.proptechusa.ai", "description": "Commercial host (preferred): PropTechUSA UFC Intelligence API gateway" }, { "url": "https://ufc-api.propbetedge.ai", "description": "Canonical / first-party host (PropBetEdge). Same contract; backwards compatible." } ], "security": [ { "BearerAuth": [] }, { "ApiKeyAuth": [] } ], "tags": [ { "name": "Core", "description": "Events, cards, fighters, bouts, results, rankings, search, counts (SOURCE_FACT)." }, { "name": "Fight DNA", "description": "Proprietary PropBetEdge fighter intelligence (PBE_DERIVED). Pro and above." }, { "name": "Matchup DNA", "description": "Fighter-vs-fighter intelligence with threshold-gated insights (PBE_DERIVED). Ultra and above." }, { "name": "Fight Week", "description": "Fight State Ledger and event intelligence. Ultra and above." }, { "name": "Media", "description": "Image metadata with license + attribution; official video metadata (no rehosting)." }, { "name": "Editorial", "description": "PropBetEdge newsroom content (EDITORIAL)." } ], "paths": { "/v1/ufc": { "get": { "summary": "API index (advertises every route and the media base URL)", "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc)", "value": { "ok": true, "data": { "name": "PropSports UFC API", "version": "2026-09-06.3", "status": "beta", "principles": [ "read-only contract", "source-grounded normalized facts", "explicit nulls and unavailable states", "no fabricated rankings, odds, predictions, or editorial facts" ], "media_base_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media", "endpoints": { "events": "/v1/ufc/events", "event": "/v1/ufc/events/{id}", "card": "/v1/ufc/events/{id}/card?include=media,results,stats", "event_articles": "/v1/ufc/events/{id}/articles", "fighters": "/v1/ufc/fighters", "fighters_media": "/v1/ufc/fighters/media?ids=a,b,c", "fighter": "/v1/ufc/fighters/{id}?include=media,ranking,next,history,stats", "fighter_history": "/v1/ufc/fighters/{id}/history", "fighter_stats": "/v1/ufc/fighters/{id}/stats", "fighter_articles": "/v1/ufc/fighters/{id}/articles", "bout": "/v1/ufc/bouts/{id}", "bout_stats": "/v1/ufc/bouts/{id}/stats", "results": "/v1/ufc/results", "rankings": "/v1/ufc/rankings?division=MIDDLEWEIGHT", "news": "/v1/ufc/news", "wire": "/v1/ufc/wire?limit=20", "article": "/v1/ufc/articles/{slug}", "search": "/v1/ufc/search?q=volkanovski", "counts": "/v1/ufc/counts", "dna_metrics": "/v1/ufc/dna/metrics", "dna_query": "/v1/ufc/dna/query?metric=pace_retention_r3_vs_r1&min=0.9&min_confidence=low&limit=50", "fighter_dna": "/v1/ufc/fighters/{id}/dna?as_of=YYYY-MM-DD", "fighter_splits": "/v1/ufc/fighters/{id}/splits?opponent_stance=SOUTHPAW", "fighter_round_profile": "/v1/ufc/fighters/{id}/round-profile", "fighter_finish_profile": "/v1/ufc/fighters/{id}/finish-profile", "fighter_position_profile": "/v1/ufc/fighters/{id}/position-profile", "matchup_dna": "/v1/ufc/matchups/{fighterA}/{fighterB}/dna?as_of=YYYY-MM-DD", "bout_ledger": "/v1/ufc/bouts/{id}/ledger?limit=25", "event_intelligence": "/v1/ufc/events/{id}/intelligence", "videos": "/v1/ufc/videos?limit=20&type=&fighter_id=&event_id=&bout_id=", "fighter_videos": "/v1/ufc/fighters/{id}/videos", "event_videos": "/v1/ufc/events/{id}/videos", "bout_videos": "/v1/ufc/bouts/{id}/videos" } }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "ae64b06b-d635-47f1-b07d-48b3dc66b823", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "index", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/events": { "get": { "summary": "List UFC events", "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string", "enum": [ "all", "upcoming", "recent" ], "default": "all" } }, { "name": "date", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 25 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/events?status=upcoming&limit=3)", "value": { "ok": true, "data": [ { "id": "187505ab-636d-4f90-8d5f-d98ebfd1cd7c", "ufcstats_id": null, "espn_event_id": "600060736", "name": "Dana White's Contender Series: Season 10, Week 5", "event_date": "2026-09-08", "venue": "Meta APEX", "city": "Las Vegas", "region": "NV", "country": "USA", "commission": null, "is_ppv": null, "card_status": "announced", "updated_at": "2026-09-07T06:03:34.55+00:00" }, { "id": "1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52", "ufcstats_id": "638cfec7ec559d6e", "espn_event_id": "600060772", "name": "Noche UFC: Silva vs. Delgado", "event_date": "2026-09-12", "venue": "Desert Diamond Arena", "city": "Glendale", "region": "AZ", "country": "USA", "commission": null, "is_ppv": null, "card_status": "announced", "updated_at": "2026-09-07T06:03:41.716+00:00" }, { "id": "64bfa864-454c-4d0a-92e3-408f25598d6c", "ufcstats_id": null, "espn_event_id": "600060737", "name": "Dana White's Contender Series: Season 10, Week 6", "event_date": "2026-09-15", "venue": "Meta APEX", "city": "Las Vegas", "region": "NV", "country": "USA", "commission": null, "is_ppv": null, "card_status": "announced", "updated_at": "2026-09-07T06:03:57.561+00:00" } ], "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "299c1248-929c-4612-aa4c-f221e5f1d01a", "count": 3, "total": 17, "status": "upcoming", "date": null, "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "events", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/events/{id}": { "get": { "summary": "Get an event by UUID, UFCStats ID, or ESPN event ID", "parameters": [ { "$ref": "#/components/parameters/EntityId" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/events/1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52)", "value": { "ok": true, "data": { "id": "1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52", "ufcstats_id": "638cfec7ec559d6e", "espn_event_id": "600060772", "name": "Noche UFC: Silva vs. Delgado", "event_date": "2026-09-12", "venue": "Desert Diamond Arena", "city": "Glendale", "region": "AZ", "country": "USA", "commission": null, "is_ppv": null, "card_status": "announced", "updated_at": "2026-09-07T06:03:41.716+00:00" }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "d4a9a109-e1c7-420c-9665-c918448d7a68", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "event", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/events/{id}/card": { "get": { "summary": "Event plus its complete ordered card (composite event-page contract)", "description": "`data.event` plus `data.bouts[]` ordered main event first. Each bout carries `fighter_a` / `fighter_b` with `images[]` and `primary_image`, and `result` (null when unfought). `include=stats` adds `round_stats[]` (both fighters, every round) and `stat_totals` keyed by fighter id to each bout, in one request. `media` and `results` are accepted for symmetry and are always on.\n\n**Plan:** Developer and above. **Origin:** SOURCE_FACT. **Parameter gates:** `include=stats` requires **pro** (adds round_stats[] and stat_totals to every bout).", "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "$ref": "#/components/parameters/CardInclude" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/events/1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52/card)", "value": { "ok": true, "data": { "event": { "id": "1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52", "ufcstats_id": "638cfec7ec559d6e", "espn_event_id": "600060772", "name": "Noche UFC: Silva vs. Delgado", "event_date": "2026-09-12", "venue": "Desert Diamond Arena", "city": "Glendale", "region": "AZ", "country": "USA", "commission": null, "is_ppv": null, "card_status": "announced", "updated_at": "2026-09-07T06:03:41.716+00:00" }, "bouts": [ { "id": "89e38074-f431-4bc3-b51e-fe42058e60d0", "ufcstats_id": null, "espn_competition_id": "401914462", "event_id": "1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52", "weight_class": "FEATHERWEIGHT", "weight_class_raw": "Featherweight", "is_womens": false, "is_title": false, "scheduled_rounds": 5, "card_position": "main", "bout_order": 13, "status": "announced", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "eed368a5-484b-412f-9d2c-a4fd6d24d019", "dob": "1996-12-27", "name": "Jean Silva", "stance": "ORTHODOX", "nickname": "Lord", "reach_in": 69, "record_d": 0, "record_l": 3, "record_w": 17, "height_in": 67, "is_active": true, "record_nc": null, "weight_lbs": 146, "ufcstats_id": "52ef95b5860fb28c", "espn_athlete_id": "5145766", "primary_image": { "id": "776d6a0a-e701-4756-b789-912addfd276d", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/eed368a5-484b-412f-9d2c-a4fd6d24d019/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/eed368a5-484b-412f-9d2c-a4fd6d24d019/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/eed368a5-484b-412f-9d2c-a4fd6d24d019/thumb.jpg", "author": "The White House", "license": "Public domain", "source_url": "https://commons.wikimedia.org/wiki/File:Jean_Silva_(54451587575).jpg", "kind": "wikimedia", "attribution_text": "The White House (U.S. Government work), Public domain, via Wikimedia Commons", "rights_label": "Public domain" } }, "fighter_b": { "id": "55ef67ad-88fe-4f7a-b4cb-dc9a10c12feb", "dob": "1998-04-21", "name": "Jose Miguel Delgado", "stance": "SWITCH", "nickname": null, "reach_in": 73, "record_d": 0, "record_l": 2, "record_w": 12, "height_in": 71, "is_active": true, "record_nc": 0, "weight_lbs": 146, "ufcstats_id": "7d6ceff6747f2de2", "espn_athlete_id": "5223435", "primary_image": null }, "result": null }, { "id": "7300eba4-285f-4030-9f3f-216fa376f451", "ufcstats_id": "1aa008d8597a73b8", "espn_competition_id": "401897731", "event_id": "1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52", "weight_class": "FLYWEIGHT", "weight_class_raw": "Flyweight", "is_womens": false, "is_title": false, "scheduled_rounds": 3, "card_position": "main", "bout_order": 12, "status": "announced", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "1fa71f4b-3f7d-4705-ba00-1f6bcf397b9a", "dob": "1993-12-07", "name": "Brandon Moreno", "stance": "ORTHODOX", "nickname": "The Assassin Baby", "reach_in": 70, "record_d": 2, "record_l": 10, "record_w": 23, "height_in": 67, "is_active": true, "record_nc": 0, "weight_lbs": 125, "ufcstats_id": "792be9a24df82ed6", "espn_athlete_id": "3027545", "primary_image": { "id": "940b4873-af29-4d7e-a94d-aaa986a5f4e8", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/1fa71f4b-3f7d-4705-ba00-1f6bcf397b9a/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/1fa71f4b-3f7d-4705-ba00-1f6bcf397b9a/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/1fa71f4b-3f7d-4705-ba00-1f6bcf397b9a/thumb.jpg", "author": "DiarioMMA", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Brandon_Moreno_February_2021.jpg", "kind": "wikimedia", "attribution_text": "DiarioMMA, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" } }, "fighter_b": { "id": "5be77aa0-2a5b-4a31-90b8-5f5b7513e0e7", "dob": "1994-08-22", "name": "Joseph Morales", "stance": "SWITCH", "nickname": "Bopo", "reach_in": 68, "record_d": 0, "record_l": 2, "record_w": 15, "height_in": 66, "is_active": true, "record_nc": 0, "weight_lbs": 125, "ufcstats_id": "2fe9032955c2e013", "espn_athlete_id": "4238229", "primary_image": null }, "result": null } ] }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "9ff18c79-ee61-4832-b2d5-1a45c9d7b9ab", "include": [], "bouts": 13, "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "event_card", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/events/{id}/articles": { "get": { "summary": "Published articles attached to an event, with resolved hero media", "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 12 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Editorial" ], "operationId": "event_articles", "x-plan": "developer", "x-feature": "editorial", "x-origin": "EDITORIAL", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** EDITORIAL." } }, "/v1/ufc/events/{id}/videos": { "get": { "summary": "Fight-week video rail for an event (chronological, grouped by video_type)", "description": "`{ event: compact, videos: Video[] (chronological), groups: [ { video_type, label, count, first_published_at, last_published_at, videos } ] }` with groups in the fight-week order given by `meta.timeline_order` (fight_preview, countdown, embedded_episode, interview, analysis, press_conference, media_day, weigh_in, faceoff, full_fight, highlights, post_fight, other).\n\n**Plan:** Developer and above. **Origin:** THIRD_PARTY_LINK.", "tags": [ "Media" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 100 } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/VideoType" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "event_videos", "x-plan": "developer", "x-feature": "video_metadata", "x-origin": "THIRD_PARTY_LINK", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/events/{id}/intelligence": { "get": { "summary": "Card intelligence, latest ledger checkpoint per bout with diff summary and source availability", "description": "One `IntelligenceBout` per bout on the card (main event first) from the latest ledger checkpoint: `hours_to_start`, bout state, fighters, `has_dna` per side, `wire_count`, `result.status`, source statuses and the diff versus the previous checkpoint. `meta.checkpoints` counts rows per checkpoint and `meta.unavailable_sources` lists weigh_in/odds/market/model sources unavailable on every bout. `card_shock` is `{status: not_computed, reason: card_shock_engine_not_built}` until the engine exists.\n\n**Plan:** Ultra and above. **Origin:** PBE_DERIVED.", "tags": [ "Fight Week" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "event_intelligence", "x-plan": "ultra", "x-feature": "fight_week", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": false, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters": { "get": { "summary": "Search/list fighters (each row carries a compact primary_image)", "description": "Rows are `Fighter` plus `primary_image` (`PrimaryImage` or null). The full `images[]` array is only on fighter detail so archive grids stay small. `meta.with_media` counts rows with a resolved portrait.\n\n**Plan:** Developer and above. **Origin:** SOURCE_FACT.", "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 100 } }, { "name": "active", "in": "query", "schema": { "type": "boolean" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 250, "default": 60 } }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "fighters", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/media": { "get": { "summary": "Bulk primary_image lookup for archive grids (max 150 ids)", "description": "`data.media` is an object keyed by every requested fighter UUID whose value is `PrimaryImage` or null. `meta.requested` / `meta.found` summarize coverage.\n\n**Plan:** Developer and above. **Origin:** MEDIA.", "parameters": [ { "name": "ids", "in": "query", "required": true, "description": "Comma-separated fighter UUIDs (1..150).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Media" ], "operationId": "fighters_media", "x-plan": "developer", "x-feature": "media_metadata", "x-origin": "MEDIA", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}": { "get": { "summary": "Fighter profile (composite fighter-page contract via include)", "description": "Default response is the fighter row plus `slug_id`, `images[]` (full licensed media with `image_url`, `card_url`, `thumb_url`) and `primary_image`. Includes are additive and never change the base fields: `ranking` adds `ranking` (verified positions or null when no snapshot), `next` adds `next_bout` (next scheduled bout with event + opponent, or null), `history` adds `history[]` (bout + event + opponent + result + outcome, newest first, `history_limit` 1..250), `stats` adds `stats` (`career_snapshot` display-only fields with the leakage warning, plus `computed` per-bout totals and career aggregates from UFC Stats round rows, with provenance). `media` is accepted and always on.\n\n**Plan:** Developer and above. **Origin:** SOURCE_FACT. **Parameter gates:** `include=stats` requires **pro** (adds computed career rates to the fighter composite).", "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "$ref": "#/components/parameters/FighterInclude" }, { "name": "history_limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 250, "default": 100 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672?include=ranking,next)", "value": { "ok": true, "data": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "name": "Sean Strickland", "nickname": null, "dob": "1991-02-27", "height_in": 73, "reach_in": 76, "weight_lbs": 185, "stance": "ORTHODOX", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "is_active": true, "career_slpm": 6.04, "career_str_acc": 42, "career_sapm": 4.57, "career_str_def": 60, "career_td_avg": 0.71, "career_td_acc": 64, "career_td_def": 76, "career_sub_avg": 0.2, "fight_history_count": 24, "updated_at": "2026-09-06T13:27:34.78+00:00", "slug_id": "3093653", "images": [ { "id": "006e6554-f441-4892-8a49-30409d01e52e", "kind": "wikimedia", "r2_key": "fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "license": "CC BY-SA 4.0", "author": "MMAnytt", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "created_at": "2026-09-06T13:37:16.778175+00:00", "source_family": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0", "rights_expires_at": null, "stored_first_party": true, "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg" } ], "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "ranking": { "source": "ufc.com official rankings", "source_url": "https://www.ufc.com/rankings", "snapshot_date": "2026-09-06", "captured_at": "2026-09-06T16:10:07.916+00:00", "positions": [ { "division": "P4P", "label": "Men's Pound-for-Pound", "is_womens": false, "is_p4p": true, "rank": 7, "is_champion": false, "change": 0, "is_new": false }, { "division": "MIDDLEWEIGHT", "label": "Middleweight", "is_womens": false, "is_p4p": false, "rank": 0, "is_champion": true, "change": null, "is_new": false } ] }, "next_bout": null }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "e45207f5-caba-4ac6-a5b4-f4bacb0c9c85", "include": [ "ranking", "next" ], "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "fighter", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/history": { "get": { "summary": "Fighter bout history with event context, opponent and outcome", "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 250, "default": 100 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/history?limit=3)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "name": "Sean Strickland", "nickname": null, "dob": "1991-02-27", "height_in": 73, "reach_in": 76, "weight_lbs": 185, "stance": "ORTHODOX", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "is_active": true, "career_slpm": 6.04, "career_str_acc": 42, "career_sapm": 4.57, "career_str_def": 60, "career_td_avg": 0.71, "career_td_acc": 64, "career_td_def": 76, "career_sub_avg": 0.2, "fight_history_count": 24, "updated_at": "2026-09-06T13:27:34.78+00:00" }, "bouts": [ { "id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "ufcstats_id": "70f1621080b3435c", "espn_competition_id": "401864353", "event_id": "de5d4510-50c9-4989-b6e6-4c7ca52f0ede", "weight_class": "MIDDLEWEIGHT", "weight_class_raw": "Middleweight", "is_womens": false, "is_title": false, "scheduled_rounds": 5, "card_position": "main", "bout_order": 13, "status": "complete", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "82f23ba8-2053-4f0f-88e3-8216893e2f28", "dob": "1994-05-01", "name": "Khamzat Chimaev", "stance": "ORTHODOX", "nickname": "Borz", "reach_in": 75, "record_d": 0, "record_l": 1, "record_w": 15, "height_in": 74, "is_active": true, "record_nc": 0, "weight_lbs": 185, "ufcstats_id": "767755fd74662dbf", "espn_athlete_id": "4684751" }, "fighter_b": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "dob": "1991-02-27", "name": "Sean Strickland", "stance": "ORTHODOX", "nickname": null, "reach_in": 76, "record_d": 0, "record_l": 7, "record_w": 31, "height_in": 73, "is_active": true, "record_nc": 0, "weight_lbs": 185, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653" }, "result": { "round": 5, "method": "DEC_S", "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "judge_1": "Sue Sanidad", "judge_2": "Eric Colon", "judge_3": "Sal D'amato", "referee": "Herb Dean", "time_sec": 300, "has_stats": true, "winner_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "method_raw": "Decision - Split", "scorecards": [ { "judge": "Sue Sanidad", "score": "48-47" }, { "judge": "Eric Colon", "score": "47-48" }, { "judge": "Sal D'amato", "score": "47-48" } ], "captured_at": "2026-09-06T13:31:27.882+00:00", "time_format": "5 Rnd (5-5-5-5-5)", "finish_detail": null, "result_source": "espn" }, "event": { "id": "de5d4510-50c9-4989-b6e6-4c7ca52f0ede", "city": "Newark", "name": "UFC 328: Chimaev vs. Strickland", "venue": "Prudential Center", "is_ppv": null, "region": "NJ", "country": "USA", "commission": null, "event_date": "2026-05-09", "updated_at": "2026-09-07T06:01:34.903+00:00", "card_status": "complete", "ufcstats_id": "9eedac48b497de5a", "espn_event_id": "600058947" }, "is_fighter_a": false, "opponent": { "id": "82f23ba8-2053-4f0f-88e3-8216893e2f28", "name": "Khamzat Chimaev", "nickname": "Borz", "ufcstats_id": "767755fd74662dbf", "espn_athlete_id": "4684751", "slug_id": "4684751", "record_w": 15, "record_l": 1, "record_d": 0, "record_nc": 0, "primary_image": null }, "outcome": "W" }, { "id": "f39afe57-7d82-4f76-b263-f5c2eea2e097", "ufcstats_id": "8d740c844353ae0e", "espn_competition_id": "401838301", "event_id": "ce387df8-d8fc-4a1f-b644-3628e803cb16", "weight_class": "MIDDLEWEIGHT", "weight_class_raw": "Middleweight", "is_womens": false, "is_title": false, "scheduled_rounds": 5, "card_position": "main", "bout_order": 14, "status": "complete", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "dob": "1991-02-27", "name": "Sean Strickland", "stance": "ORTHODOX", "nickname": null, "reach_in": 76, "record_d": 0, "record_l": 7, "record_w": 31, "height_in": 73, "is_active": true, "record_nc": 0, "weight_lbs": 185, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653" }, "fighter_b": { "id": "60491150-2bf5-43c0-bdac-73118b5d3937", "dob": "1993-10-18", "name": "Anthony Hernandez", "stance": "ORTHODOX", "nickname": "Fluffy", "reach_in": 75, "record_d": 0, "record_l": 4, "record_w": 15, "height_in": 72, "is_active": true, "record_nc": 1, "weight_lbs": 186, "ufcstats_id": "093e1f5bb73850be", "espn_athlete_id": "4290956" }, "result": { "round": 3, "method": "KO_TKO", "bout_id": "f39afe57-7d82-4f76-b263-f5c2eea2e097", "judge_1": null, "judge_2": null, "judge_3": null, "referee": "Herb Dean", "time_sec": 143, "has_stats": true, "winner_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "method_raw": "KO/TKO", "scorecards": null, "captured_at": "2026-09-06T01:39:15.154733+00:00", "time_format": "5 Rnd (5-5-5-5-5)", "finish_detail": "Punches to Head On Ground", "result_source": "ufcstats" }, "event": { "id": "ce387df8-d8fc-4a1f-b644-3628e803cb16", "city": "Houston", "name": "UFC Fight Night: Strickland vs. Hernandez", "venue": "Toyota Center (Houston)", "is_ppv": null, "region": "TX", "country": "USA", "commission": null, "event_date": "2026-02-21", "updated_at": "2026-09-07T06:01:12.886+00:00", "card_status": "complete", "ufcstats_id": "79ab17db3b40831a", "espn_event_id": "600057329" }, "is_fighter_a": true, "opponent": { "id": "60491150-2bf5-43c0-bdac-73118b5d3937", "name": "Anthony Hernandez", "nickname": "Fluffy", "ufcstats_id": "093e1f5bb73850be", "espn_athlete_id": "4290956", "slug_id": "4290956", "record_w": 15, "record_l": 4, "record_d": 0, "record_nc": 1, "primary_image": null }, "outcome": "W" }, { "id": "815fe985-9681-4106-b5f5-e3086125e036", "ufcstats_id": null, "espn_competition_id": "401729651", "event_id": "4da5492f-1192-402d-9760-0647a385d392", "weight_class": "MIDDLEWEIGHT", "weight_class_raw": "Middleweight", "is_womens": false, "is_title": false, "scheduled_rounds": 5, "card_position": "main", "bout_order": 12, "status": "complete", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "9a3b2a15-27d8-4554-9217-42ef2dd5d25c", "dob": "1994-01-14", "name": "Dricus Du Plessis", "stance": "SWITCH", "nickname": "Stilknocks", "reach_in": 76, "record_d": 0, "record_l": 3, "record_w": 24, "height_in": 73, "is_active": true, "record_nc": 0, "weight_lbs": 185, "ufcstats_id": "0d7b51c9d2649a6e", "espn_athlete_id": "3166126" }, "fighter_b": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "dob": "1991-02-27", "name": "Sean Strickland", "stance": "ORTHODOX", "nickname": null, "reach_in": 76, "record_d": 0, "record_l": 7, "record_w": 31, "height_in": 73, "is_active": true, "record_nc": 0, "weight_lbs": 185, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653" }, "result": { "round": 5, "method": "DEC_U", "bout_id": "815fe985-9681-4106-b5f5-e3086125e036", "judge_1": null, "judge_2": null, "judge_3": null, "referee": "Marc Goddard", "time_sec": 300, "has_stats": false, "winner_id": "9a3b2a15-27d8-4554-9217-42ef2dd5d25c", "method_raw": "Decision - Unanimous", "scorecards": null, "captured_at": "2026-09-06T13:43:08.183+00:00", "time_format": "5 Rnd (5-5-5-5-5)", "finish_detail": null, "result_source": "espn" }, "event": { "id": "4da5492f-1192-402d-9760-0647a385d392", "city": "Sydney", "name": "UFC 312: Du Plessis vs. Strickland 2", "venue": "Qudos Bank Arena", "is_ppv": null, "region": "New South Wales", "country": "Australia", "commission": null, "event_date": "2025-02-08", "updated_at": "2026-09-06T13:54:46.369281+00:00", "card_status": "complete", "ufcstats_id": "e6015889f50075d2", "espn_event_id": "600050481" }, "is_fighter_a": false, "opponent": { "id": "9a3b2a15-27d8-4554-9217-42ef2dd5d25c", "name": "Dricus Du Plessis", "nickname": "Stilknocks", "ufcstats_id": "0d7b51c9d2649a6e", "espn_athlete_id": "3166126", "slug_id": "3166126", "record_w": 24, "record_l": 3, "record_d": 0, "record_nc": 0, "primary_image": null }, "outcome": "L" } ] }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "98c04fc9-7b5a-4f46-8c7e-da46c844adba", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "fighter_history", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/fighters/{id}/stats": { "get": { "summary": "Career snapshot plus round-stat rows and computed aggregates", "description": "`career_snapshot` fields are display-only and explicitly not valid as historical as-of model features. `round_stats[]` is every UFC Stats round row for the fighter; `computed` sums them per bout and across the career with labelled provenance (`fight_time_basis`).\n\n**Plan:** Pro and above. **Origin:** PBE_DERIVED.", "parameters": [ { "$ref": "#/components/parameters/EntityId" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/stats)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "name": "Sean Strickland" }, "career_snapshot": { "slpm": 6.04, "striking_accuracy": 42, "sapm": 4.57, "striking_defense": 60, "takedown_average": 0.71, "takedown_accuracy": 64, "takedown_defense": 76, "submission_average": 0.2 }, "warning": "Career snapshot fields are display-only and must not be used as historical model features because they include future information relative to older bouts.", "round_stats": [ { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 1, "kd": 0, "sig_str_landed": 0, "sig_str_att": 0, "total_str_landed": 12, "total_str_att": 13, "td_landed": 0, "td_att": 0, "sub_att": 0, "rev": 0, "ctrl_sec": 0, "head_landed": 0, "head_att": 0, "body_landed": 0, "body_att": 0, "leg_landed": 0, "leg_att": 0, "distance_landed": 0, "distance_att": 0, "clinch_landed": 0, "clinch_att": 0, "ground_landed": 0, "ground_att": 0, "captured_at": "2026-09-06T16:46:39.629853+00:00" }, { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 2, "kd": 0, "sig_str_landed": 15, "sig_str_att": 38, "total_str_landed": 29, "total_str_att": 57, "td_landed": 0, "td_att": 0, "sub_att": 0, "rev": 0, "ctrl_sec": 181, "head_landed": 15, "head_att": 37, "body_landed": 0, "body_att": 1, "leg_landed": 0, "leg_att": 0, "distance_landed": 12, "distance_att": 33, "clinch_landed": 0, "clinch_att": 0, "ground_landed": 3, "ground_att": 5, "captured_at": "2026-09-06T16:46:39.629869+00:00" } ], "computed": { "provenance": { "source": "ufcstats_round_stats", "method": "Totals are sums of per-round UFC Stats rows for this fighter. Rates use elapsed fight time from the recorded result (final round + clock), or rounds x 5:00 when no result exists.", "bouts_with_stats": 2, "rounds": 8, "fight_time_sec": 2243, "fight_time_basis": { "result": 2, "rounds_x_5min": 0 }, "coverage_note": "Only bouts with UFC Stats round rows are included; coverage may be partial and these are not as-of model features." }, "career_totals": { "kd": 1, "sig_str_landed": 233, "sig_str_att": 553, "total_str_landed": 271, "total_str_att": 597, "td_landed": 0, "td_att": 1, "sub_att": 0, "rev": 0, "ctrl_sec": 199, "head_landed": 211, "head_att": 521, "body_landed": 14, "body_att": 24, "leg_landed": 8, "leg_att": 8, "distance_landed": 220, "distance_att": 536, "clinch_landed": 3, "clinch_att": 4, "ground_landed": 10, "ground_att": 13 }, "career_rates": { "sig_str_landed_per_min": 6.23, "sig_str_accuracy": 0.4213, "total_str_accuracy": 0.4539, "td_per_15min": 0, "td_accuracy": 0, "sub_att_per_15min": 0, "kd_per_15min": 0.4, "ctrl_share": 0.0887, "head_share": 0.9056, "body_share": 0.0601, "leg_share": 0.0343, "distance_share": 0.9442, "clinch_share": 0.0129, "ground_share": 0.0429 }, "bouts": [ { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "event": { "id": "de5d4510-50c9-4989-b6e6-4c7ca52f0ede", "name": "UFC 328: Chimaev vs. Strickland", "event_date": "2026-05-09", "venue": "Prudential Center", "city": "Newark", "region": "NJ", "country": "USA", "card_status": "complete", "espn_event_id": "600058947", "ufcstats_id": "9eedac48b497de5a" }, "opponent": { "id": "82f23ba8-2053-4f0f-88e3-8216893e2f28", "name": "Khamzat Chimaev", "nickname": "Borz", "ufcstats_id": "767755fd74662dbf", "espn_athlete_id": "4684751", "slug_id": "4684751", "record_w": 15, "record_l": 1, "record_d": 0, "record_nc": 0, "primary_image": { "id": "f78a5cde-b382-415e-9d86-64a3a10e4669", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/82f23ba8-2053-4f0f-88e3-8216893e2f28/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/82f23ba8-2053-4f0f-88e3-8216893e2f28/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/82f23ba8-2053-4f0f-88e3-8216893e2f28/thumb.jpg", "author": "MMAnytt", "license": "CC BY 3.0", "source_url": "https://commons.wikimedia.org/wiki/File:Khamzat_Chimaev_2022.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY 3.0, via Wikimedia Commons", "rights_label": "CC BY 3.0" } }, "result": { "round": 5, "method": "DEC_S", "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "judge_1": "Sue Sanidad", "judge_2": "Eric Colon", "judge_3": "Sal D'amato", "referee": "Herb Dean", "time_sec": 300, "has_stats": true, "winner_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "method_raw": "Decision - Split", "scorecards": [ { "judge": "Sue Sanidad", "score": "48-47" }, { "judge": "Eric Colon", "score": "47-48" }, { "judge": "Sal D'amato", "score": "47-48" } ], "captured_at": "2026-09-06T13:31:27.882+00:00", "time_format": "5 Rnd (5-5-5-5-5)", "finish_detail": null, "result_source": "espn" }, "outcome": "W", "rounds": 5, "fight_time_sec": 1500, "fight_time_basis": "result", "totals": { "kd": 0, "sig_str_landed": 123, "sig_str_att": 312, "total_str_landed": 160, "total_str_att": 355, "td_landed": 0, "td_att": 1, "sub_att": 0, "rev": 0, "ctrl_sec": 181, "head_landed": 118, "head_att": 302, "body_landed": 5, "body_att": 10, "leg_landed": 0, "leg_att": 0, "distance_landed": 119, "distance_att": 306, "clinch_landed": 1, "clinch_att": 1, "ground_landed": 3, "ground_att": 5 }, "rounds_detail": [ { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 1, "kd": 0, "sig_str_landed": 0, "sig_str_att": 0, "total_str_landed": 12, "total_str_att": 13, "td_landed": 0, "td_att": 0, "sub_att": 0, "rev": 0, "ctrl_sec": 0, "head_landed": 0, "head_att": 0, "body_landed": 0, "body_att": 0, "leg_landed": 0, "leg_att": 0, "distance_landed": 0, "distance_att": 0, "clinch_landed": 0, "clinch_att": 0, "ground_landed": 0, "ground_att": 0, "captured_at": "2026-09-06T16:46:39.629853+00:00" }, { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 2, "kd": 0, "sig_str_landed": 15, "sig_str_att": 38, "total_str_landed": 29, "total_str_att": 57, "td_landed": 0, "td_att": 0, "sub_att": 0, "rev": 0, "ctrl_sec": 181, "head_landed": 15, "head_att": 37, "body_landed": 0, "body_att": 1, "leg_landed": 0, "leg_att": 0, "distance_landed": 12, "distance_att": 33, "clinch_landed": 0, "clinch_att": 0, "ground_landed": 3, "ground_att": 5, "captured_at": "2026-09-06T16:46:39.629869+00:00" }, { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 3, "kd": 0, "sig_str_landed": 43, "sig_str_att": 100, "total_str_landed": 43, "total_str_att": 100, "td_landed": 0, "td_att": 0, "sub_att": 0, "rev": 0, "ctrl_sec": 0, "head_landed": 42, "head_att": 98, "body_landed": 1, "body_att": 2, "leg_landed": 0, "leg_att": 0, "distance_landed": 43, "distance_att": 100, "clinch_landed": 0, "clinch_att": 0, "ground_landed": 0, "ground_att": 0, "captured_at": "2026-09-06T16:46:39.629881+00:00" }, { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 4, "kd": 0, "sig_str_landed": 34, "sig_str_att": 86, "total_str_landed": 38, "total_str_att": 90, "td_landed": 0, "td_att": 0, "sub_att": 0, "rev": 0, "ctrl_sec": 0, "head_landed": 33, "head_att": 84, "body_landed": 1, "body_att": 2, "leg_landed": 0, "leg_att": 0, "distance_landed": 34, "distance_att": 86, "clinch_landed": 0, "clinch_att": 0, "ground_landed": 0, "ground_att": 0, "captured_at": "2026-09-06T16:46:39.629898+00:00" }, { "bout_id": "6ce6361a-bcc0-492f-86a6-b0ee1bf591c8", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "round": 5, "kd": 0, "sig_str_landed": 31, "sig_str_att": 88, "total_str_landed": 38, "total_str_att": 95, "td_landed": 0, "td_att": 1, "sub_att": 0, "rev": 0, "ctrl_sec": 0, "head_landed": 28, "head_att": 83, "body_landed": 3, "body_att": 5, "leg_landed": 0, "leg_att": 0, "distance_landed": 30, "distance_att": 87, "clinch_landed": 1, "clinch_att": 1, "ground_landed": 0, "ground_att": 0, "captured_at": "2026-09-06T16:46:39.629918+00:00" } ] } ] } }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "5deee28a-98f1-48dc-a89c-fdaf9ea5d029", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "fighter_stats", "x-plan": "pro", "x-feature": "round_stats_deep", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/articles": { "get": { "summary": "Published articles tagged with a fighter, with resolved hero media", "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 8 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Editorial" ], "operationId": "fighter_articles", "x-plan": "developer", "x-feature": "editorial", "x-origin": "EDITORIAL", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** EDITORIAL." } }, "/v1/ufc/fighters/{id}/videos": { "get": { "summary": "Published official videos linked to a fighter, newest first", "description": "`{ fighter: compact (with primary_image), videos: Video[] }`.\n\n**Plan:** Developer and above. **Origin:** THIRD_PARTY_LINK.", "tags": [ "Media" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/VideoType" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "fighter_videos", "x-plan": "developer", "x-feature": "video_metadata", "x-origin": "THIRD_PARTY_LINK", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/dna": { "get": { "summary": "Fighter Fight DNA snapshot (latest, or latest at/before as_of)", "description": "`data.fighter` (compact, with `primary_image`, `stance`, `is_active`) plus `data.snapshot` (`DnaSnapshot`). `as_of_date` is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D; `?as_of=D` resolves to the latest snapshot with `as_of_date <= D` (`meta.requested_as_of`, `meta.resolved_as_of`). `404 dna_not_available` with `data:null` when no snapshot exists (`detail.reason = no_snapshot | no_snapshot_at_or_before_as_of`); `503 dna_not_available` while the schema is not applied. Nothing is synthesized.\n\n**Plan:** Pro and above. **Origin:** PBE_DERIVED. **Parameter gates:** `as_of=…` requires **pro** (historical as-of reconstruction).", "tags": [ "Fight DNA" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/dna)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "nickname": null, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "stance": "ORTHODOX", "is_active": true }, "snapshot": { "as_of_date": "2026-09-06", "definition_version": 1, "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "metrics": { "sig_landed_per_min": { "unit": "per_min", "value": 6.2327, "origin": "pbe_derived", "numerator": 233, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_landed_per_min", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_absorbed_per_min": { "unit": "per_min", "value": 4.0927, "origin": "pbe_derived", "numerator": 153, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_absorbed_per_min", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_accuracy": { "unit": "ratio", "value": 0.4213, "origin": "pbe_derived", "numerator": 233, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_accuracy", "denominator": 553, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "td_attempts_per_15": { "unit": "per_15", "value": 0.4012, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "td_attempts_per_15", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "finish_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "pace_retention_r3_vs_r1": { "unit": "ratio", "value": 2.5884, "origin": "pbe_derived", "numerator": 23.2957, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "pace_retention_r3_vs_r1", "denominator": 9, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "stance_splits": { "SOUTHPAW": { "record": { "d": 0, "l": 0, "w": 0, "nc": 0, "appearances": 0 }, "ko_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_ko_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "sub_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_sub_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "kd_per_15": { "unit": "per_15", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_kd_rate_15", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 }, "confidence": "insufficient", "stat_bouts": 0, "finish_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_finish_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "ko_tko_wins": 0, "stat_rounds": 0, "decision_wins": 0, "record_metric": { "unit": "record", "value": { "d": 0, "l": 0, "w": 0, "nc": 0, "appearances": 0 }, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_record", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn" ], "definition_version": 1 }, "submission_wins": 0, "observed_seconds": 0, "sig_diff_per_min": { "unit": "per_min", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_sig_diff_per_min", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 }, "td_landed_per_15": { "unit": "per_15", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_td_rate_15", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "open": { "record": { "d": 0, "l": 0, "w": 0, "nc": 0, "appearances": 0 }, "ko_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_ko_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "sub_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_sub_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "kd_per_15": { "unit": "per_15", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_kd_rate_15", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 }, "confidence": "insufficient", "stat_bouts": 0, "finish_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_finish_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "ko_tko_wins": 0, "stat_rounds": 0, "decision_wins": 0, "record_metric": { "unit": "record", "value": { "d": 0, "l": 0, "w": 0, "nc": 0, "appearances": 0 }, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "open_stance_record", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn" ], "definition_version": 1 }, "submission_wins": 0, "observed_seconds": 0, "sig_diff_per_min": { "unit": "per_min", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_sig_diff_per_min", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 }, "td_landed_per_15": { "unit": "per_15", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_td_rate_15", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "…": "other stances omitted from this example" }, "round_profile": { "rounds": { "1": { "rounds": 2, "seconds": 600, "sig_att_per_min": { "unit": "per_min", "value": 9, "origin": "pbe_derived", "numerator": 90, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r1_sig_attempts_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 2.3, "origin": "pbe_derived", "numerator": 23, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r1_sig_absorbed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 3.2, "origin": "pbe_derived", "numerator": 32, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r1_sig_landed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "2": { "rounds": 2, "seconds": 600, "sig_att_per_min": { "unit": "per_min", "value": 11.7, "origin": "pbe_derived", "numerator": 117, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r2_sig_attempts_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 3.3, "origin": "pbe_derived", "numerator": 33, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r2_sig_absorbed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 5.2, "origin": "pbe_derived", "numerator": 52, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r2_sig_landed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "3": { "rounds": 2, "seconds": 443, "sig_att_per_min": { "unit": "per_min", "value": 23.2957, "origin": "pbe_derived", "numerator": 172, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r3_sig_attempts_per_min", "denominator": 443, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 443, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 5.1467, "origin": "pbe_derived", "numerator": 38, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r3_sig_absorbed_per_min", "denominator": 443, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 443, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 11.377, "origin": "pbe_derived", "numerator": 84, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r3_sig_landed_per_min", "denominator": 443, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 443, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "4": { "rounds": 1, "seconds": 300, "sig_att_per_min": { "unit": "per_min", "value": 17.2, "origin": "pbe_derived", "numerator": 86, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r4_sig_attempts_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 7.4, "origin": "pbe_derived", "numerator": 37, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r4_sig_absorbed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 6.8, "origin": "pbe_derived", "numerator": 34, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r4_sig_landed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "5": { "rounds": 1, "seconds": 300, "sig_att_per_min": { "unit": "per_min", "value": 17.6, "origin": "pbe_derived", "numerator": 88, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r5_sig_attempts_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 4.4, "origin": "pbe_derived", "numerator": 22, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r5_sig_absorbed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 6.2, "origin": "pbe_derived", "numerator": 31, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r5_sig_landed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } } }, "pace_retention_r2_vs_r1": { "unit": "ratio", "value": 1.3, "origin": "pbe_derived", "numerator": 11.7, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "pace_retention_r2_vs_r1", "denominator": 9, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1200, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "pace_retention_r3_vs_r1": { "unit": "ratio", "value": 2.5884, "origin": "pbe_derived", "numerator": 23.2957, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "pace_retention_r3_vs_r1", "denominator": 9, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "championship_round_delta": { "unit": "per_min", "value": 3.5595, "origin": "pbe_derived", "numerator": 17.4, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "championship_round_delta", "denominator": 13.8405, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "defensive_drift_r3_vs_r1": { "unit": "per_min", "value": 2.8467, "origin": "pbe_derived", "numerator": 5.1467, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "defensive_drift_r3_vs_r1", "denominator": 2.3, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "finish_profile": { "finish_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finished_by": { "ko_tko": 0, "submission": 0 }, "ko_finish_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "ko_finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finish_time_median_sec": { "unit": "seconds", "value": 743, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_time_median_sec", "denominator": null, "sample_bouts": 1, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "submission_finish_rate": { "unit": "ratio", "value": 0, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "submission_finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finish_round_distribution": { "unit": "distribution", "value": { "total": 1, "buckets": { "1": 0, "2": 0, "3": 1, "4": 0, "5": 0 } }, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_round_distribution", "denominator": 2, "sample_bouts": 1, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finished_by_round_distribution": { "unit": "distribution", "value": { "total": 0, "buckets": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 0 } }, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "finished_by_round_distribution", "denominator": 1, "sample_bouts": 0, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 } }, "context_splits": { "…": "omitted from this example" }, "position_profile": {}, "archetype": null, "provenance": { "bouts": [ "815fe985-9681-4106-b5f5-e3086125e036", "f39afe57-7d82-4f76-b263-f5c2eea2e097" ], "record": { "d": 0, "l": 1, "w": 2, "nc": 0, "appearances": 3 }, "builder": "scripts/dna/build_fight_dna.mjs@v1.1", "watermark": { "bouts": 3, "stats_captured_at": "2026-09-06T17:05:53.140855+00:00", "results_captured_at": "2026-09-06T16:55:42.217129+00:00", "round_stats_captured_at": "2026-09-06T17:05:54.119389+00:00" }, "build_run_id": "38e9445a-e7c9-4a23-bcc4-8d2c70e4a832", "fighter_stance": "ORTHODOX" }, "generated_at": "2026-09-06T18:27:53.49+00:00", "origin": "pbe_derived" } }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "bb5b2e51-f863-477d-aeb2-94486fb9fcd9", "requested_as_of": null, "resolved_as_of": "2026-09-06", "definition_version": 1, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "description": "Fighter unknown, or no Fight DNA snapshot at/before `as_of` (`dna_not_available`). Nothing is synthesized.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "dna_not_available": { "value": { "ok": false, "data": null, "error": { "code": "dna_not_available", "message": "No Fight DNA snapshot exists for Sean Strickland at or before 2024-01-01. Nothing is synthesized.", "detail": { "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "requested_as_of": "2024-01-01", "definition_version": 1, "reason": "no_snapshot_at_or_before_as_of" } }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "475fa213-d202-4353-a79d-d31519c3b4a3" } } } } } } }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "fighter_dna", "x-plan": "pro", "x-feature": "dna_fighter", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/splits": { "get": { "summary": "Fighter stance splits (record / finish profile by opponent listed stance)", "description": "`data.splits[]` are `StanceSplitRow` rows from `ufc_fighter_stance_splits` for the latest `as_of_date` (or latest <= `as_of`), ordered ORTHODOX, SOUTHPAW, SWITCH, OPEN_STANCE, SIDEWAYS, UNKNOWN. With `opponent_stance`, `data.split` is the row or an explicit null. Unknown stance values are `400 invalid_stance`.\n\n**Plan:** Pro and above. **Origin:** PBE_DERIVED. **Parameter gates:** `as_of=…` requires **pro** (historical as-of reconstruction).", "tags": [ "Fight DNA" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "opponent_stance", "in": "query", "schema": { "type": "string", "enum": [ "ORTHODOX", "SOUTHPAW", "SWITCH", "OPEN_STANCE", "SIDEWAYS", "UNKNOWN" ] } }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/splits)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "nickname": null, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "definition_version": 1, "origin": "pbe_derived", "opponent_stance": null, "splits": [ { "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "as_of_date": "2026-09-06", "opponent_stance": "ORTHODOX", "definition_version": 1, "appearances": 2, "wins": 2, "losses": 0, "draws": 0, "no_contests": 0, "ko_tko_wins": 1, "submission_wins": 0, "decision_wins": 1, "stat_bouts": 2, "stat_rounds": 8, "observed_seconds": 2243, "metrics": { "ko_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "stance_ko_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "sub_rate": { "unit": "ratio", "value": 0, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "stance_sub_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "kd_per_15": { "unit": "per_15", "value": 0.4012, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "stance_kd_rate_15", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "finish_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "stance_finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "sig_diff_per_min": { "unit": "per_min", "value": 2.14, "origin": "pbe_derived", "numerator": 80, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "stance_sig_diff_per_min", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "td_landed_per_15": { "unit": "per_15", "value": 0, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "stance_td_rate_15", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "confidence": "low", "provenance": { "builder": "scripts/dna/build_fight_dna.mjs@v1.1", "as_of_date": "2026-09-06", "build_run_id": "38e9445a-e7c9-4a23-bcc4-8d2c70e4a832" }, "generated_at": "2026-09-06T18:27:53.49+00:00", "record": { "w": 2, "l": 0, "d": 0, "nc": 0, "appearances": 2 }, "origin": "pbe_derived" }, { "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "as_of_date": "2026-09-06", "opponent_stance": "SOUTHPAW", "definition_version": 1, "appearances": 0, "wins": 0, "losses": 0, "draws": 0, "no_contests": 0, "ko_tko_wins": 0, "submission_wins": 0, "decision_wins": 0, "stat_bouts": 0, "stat_rounds": 0, "observed_seconds": 0, "metrics": { "ko_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_ko_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "sub_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_sub_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "kd_per_15": { "unit": "per_15", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_kd_rate_15", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 }, "finish_rate": { "unit": "ratio", "value": null, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_finish_rate", "denominator": 0, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "sig_diff_per_min": { "unit": "per_min", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_sig_diff_per_min", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 }, "td_landed_per_15": { "unit": "per_15", "value": null, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "stance_td_rate_15", "denominator": null, "sample_bouts": 0, "sample_rounds": 0, "sample_seconds": 0, "coverage_status": "insufficient", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "confidence": "insufficient", "provenance": { "bouts": [], "builder": "scripts/dna/build_fight_dna.mjs@6e9cbfa", "watermark": { "bouts": 3, "stats_captured_at": null, "results_captured_at": "2026-09-06T13:43:08.183+00:00", "round_stats_captured_at": "2026-09-06T01:39:16.260963+00:00" }, "build_run_id": "507ffd4c-2e92-4f4b-825f-b7e9952b9181" }, "generated_at": "2026-09-06T16:35:55.552+00:00", "record": { "w": 0, "l": 0, "d": 0, "nc": 0, "appearances": 0 }, "origin": "pbe_derived" } ] }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "21abb446-4b1a-4af6-9e36-bf8839f4fe40", "requested_as_of": null, "resolved_as_of": "2026-09-06", "definition_version": 1, "opponent_stance": null, "count": 6, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "fighter_splits", "x-plan": "pro", "x-feature": "dna_fighter", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/round-profile": { "get": { "summary": "Snapshot round_profile family with sample context", "description": "`DnaFamilyResponse` with `round_profile`; `status: insufficient_coverage` and `round_profile: null` when the family is empty.\n\n**Plan:** Pro and above. **Origin:** PBE_DERIVED. **Parameter gates:** `as_of=…` requires **pro** (historical as-of reconstruction).", "tags": [ "Fight DNA" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/round-profile)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "nickname": null, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "definition_version": 1, "origin": "pbe_derived", "sample": { "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "sample_minutes": 37.4, "coverage_status": "low" }, "available": true, "status": "ok", "round_profile": { "rounds": { "1": { "rounds": 2, "seconds": 600, "sig_att_per_min": { "unit": "per_min", "value": 9, "origin": "pbe_derived", "numerator": 90, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r1_sig_attempts_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 2.3, "origin": "pbe_derived", "numerator": 23, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r1_sig_absorbed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 3.2, "origin": "pbe_derived", "numerator": 32, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r1_sig_landed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "2": { "rounds": 2, "seconds": 600, "sig_att_per_min": { "unit": "per_min", "value": 11.7, "origin": "pbe_derived", "numerator": 117, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r2_sig_attempts_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 3.3, "origin": "pbe_derived", "numerator": 33, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r2_sig_absorbed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 5.2, "origin": "pbe_derived", "numerator": 52, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r2_sig_landed_per_min", "denominator": 600, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 600, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "3": { "rounds": 2, "seconds": 443, "sig_att_per_min": { "unit": "per_min", "value": 23.2957, "origin": "pbe_derived", "numerator": 172, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r3_sig_attempts_per_min", "denominator": 443, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 443, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 5.1467, "origin": "pbe_derived", "numerator": 38, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r3_sig_absorbed_per_min", "denominator": 443, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 443, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 11.377, "origin": "pbe_derived", "numerator": 84, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r3_sig_landed_per_min", "denominator": 443, "sample_bouts": 2, "sample_rounds": 2, "sample_seconds": 443, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "4": { "rounds": 1, "seconds": 300, "sig_att_per_min": { "unit": "per_min", "value": 17.2, "origin": "pbe_derived", "numerator": 86, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r4_sig_attempts_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 7.4, "origin": "pbe_derived", "numerator": 37, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r4_sig_absorbed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 6.8, "origin": "pbe_derived", "numerator": 34, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r4_sig_landed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } }, "5": { "rounds": 1, "seconds": 300, "sig_att_per_min": { "unit": "per_min", "value": 17.6, "origin": "pbe_derived", "numerator": 88, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r5_sig_attempts_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "absorbed_per_min": { "unit": "per_min", "value": 4.4, "origin": "pbe_derived", "numerator": 22, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r5_sig_absorbed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "sig_landed_per_min": { "unit": "per_min", "value": 6.2, "origin": "pbe_derived", "numerator": 31, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "r5_sig_landed_per_min", "denominator": 300, "sample_bouts": 1, "sample_rounds": 1, "sample_seconds": 300, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } } }, "pace_retention_r2_vs_r1": { "unit": "ratio", "value": 1.3, "origin": "pbe_derived", "numerator": 11.7, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "pace_retention_r2_vs_r1", "denominator": 9, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1200, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "pace_retention_r3_vs_r1": { "unit": "ratio", "value": 2.5884, "origin": "pbe_derived", "numerator": 23.2957, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "pace_retention_r3_vs_r1", "denominator": 9, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "championship_round_delta": { "unit": "per_min", "value": 3.5595, "origin": "pbe_derived", "numerator": 17.4, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "championship_round_delta", "denominator": 13.8405, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "defensive_drift_r3_vs_r1": { "unit": "per_min", "value": 2.8467, "origin": "pbe_derived", "numerator": 5.1467, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "defensive_drift_r3_vs_r1", "denominator": 2.3, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 } } }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "9e125062-1f50-4bba-8537-94cdac090af8", "requested_as_of": null, "resolved_as_of": "2026-09-06", "definition_version": 1, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "family": "round_profile", "available": true, "status": "ok", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "fighter_round_profile", "x-plan": "pro", "x-feature": "dna_fighter", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/finish-profile": { "get": { "summary": "Snapshot finish_profile family with sample context", "description": "`DnaFamilyResponse` with `finish_profile`; `status: insufficient_coverage` and `finish_profile: null` when the family is empty.\n\n**Plan:** Pro and above. **Origin:** PBE_DERIVED. **Parameter gates:** `as_of=…` requires **pro** (historical as-of reconstruction).", "tags": [ "Fight DNA" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/finish-profile)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "nickname": null, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "definition_version": 1, "origin": "pbe_derived", "sample": { "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "sample_minutes": 37.4, "coverage_status": "low" }, "available": true, "status": "ok", "finish_profile": { "finish_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finished_by": { "ko_tko": 0, "submission": 0 }, "ko_finish_rate": { "unit": "ratio", "value": 0.5, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "ko_finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finish_time_median_sec": { "unit": "seconds", "value": 743, "origin": "pbe_derived", "numerator": null, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_time_median_sec", "denominator": null, "sample_bouts": 1, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "submission_finish_rate": { "unit": "ratio", "value": 0, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "submission_finish_rate", "denominator": 2, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finish_round_distribution": { "unit": "distribution", "value": { "total": 1, "buckets": { "1": 0, "2": 0, "3": 1, "4": 0, "5": 0 } }, "origin": "pbe_derived", "numerator": 1, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "finish_round_distribution", "denominator": 2, "sample_bouts": 1, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "high", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 }, "finished_by_round_distribution": { "unit": "distribution", "value": { "total": 0, "buckets": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 0 } }, "origin": "pbe_derived", "numerator": 0, "as_of_date": "2026-09-06", "confidence": "insufficient", "metric_key": "finished_by_round_distribution", "denominator": 1, "sample_bouts": 0, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "insufficient", "source_families": [ "espn", "ufcstats" ], "definition_version": 1 } } }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "31a4f4a6-0fd2-4fed-86c6-d19455c143e0", "requested_as_of": null, "resolved_as_of": "2026-09-06", "definition_version": 1, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "family": "finish_profile", "available": true, "status": "ok", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "fighter_finish_profile", "x-plan": "pro", "x-feature": "dna_fighter", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/fighters/{id}/position-profile": { "get": { "summary": "Snapshot position_profile family (licensed data; explicit unavailable shape until it exists)", "description": "`DnaFamilyResponse` with `position_profile`. While no licensed position source exists the family is `{}` and the response is `status: licensed_data_not_available`, `available: false`, `position_profile: null` with a note; nothing is synthesized from UFC Stats control time. When populated `origin` is `licensed`.\n\n**Plan:** Pro and above. **Origin:** LICENSED. **Parameter gates:** `as_of=…` requires **pro** (historical as-of reconstruction).", "tags": [ "Fight DNA" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API. `status` is `licensed_data_not_available` and `position_profile` is `null` until a licensed position source exists.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/position-profile)", "value": { "ok": true, "data": { "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "nickname": null, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "definition_version": 1, "origin": "pbe_derived", "sample": { "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "sample_minutes": 37.4, "coverage_status": "low" }, "available": false, "status": "licensed_data_not_available", "position_profile": null, "note": "Position / control-time families require a licensed source (ufc_bout_position_stats). Nothing is synthesized from UFC Stats control time." }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "ab0b0aa4-3054-44d6-a46a-97875d58b943", "requested_as_of": null, "resolved_as_of": "2026-09-06", "definition_version": 1, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "family": "position_profile", "available": false, "status": "licensed_data_not_available", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "fighter_position_profile", "x-plan": "pro", "x-feature": "dna_fighter", "x-origin": "LICENSED", "x-plans": { "developer": false, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/bouts/{id}": { "get": { "summary": "Get bout, fighters, result, and event context", "parameters": [ { "$ref": "#/components/parameters/EntityId" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "bout", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/bouts/{id}/stats": { "get": { "summary": "Bout, every round-level row, per-fighter totals and provenance", "parameters": [ { "$ref": "#/components/parameters/EntityId" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "bout_stats", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/bouts/{id}/videos": { "get": { "summary": "Published official videos linked to one bout, newest first", "description": "`{ bout: compact (event, fighter_a, fighter_b), videos: Video[] }`. Event-wide fight-week videos live on /events/{id}/videos.\n\n**Plan:** Developer and above. **Origin:** THIRD_PARTY_LINK.", "tags": [ "Media" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/VideoType" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "bout_videos", "x-plan": "developer", "x-feature": "video_metadata", "x-origin": "THIRD_PARTY_LINK", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/bouts/{id}/ledger": { "get": { "summary": "Fight State Ledger snapshots for a bout, newest first, with deterministic diffs", "description": "`data.snapshots[]` are `LedgerSnapshot` rows (every block) from the append-only `ufc_fight_state_ledger`; `data.diffs[]` are `LedgerDiff` objects for consecutive snapshots (shallow, interpretation-free; see `meta.diff_rules`). `data.card_shock` is the stable `{status: not_computed}` placeholder. A bout with no rows is `200` with empty arrays; `503 ledger_not_available` while migration 005 is not applied.\n\n**Plan:** Ultra and above. **Origin:** PBE_DERIVED.", "tags": [ "Fight Week" ], "parameters": [ { "$ref": "#/components/parameters/EntityId" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "bout_ledger", "x-plan": "ultra", "x-feature": "fight_week", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": false, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/matchups/{fighterA}/{fighterB}/dna": { "get": { "summary": "Matchup Fight DNA (paired comparisons, stance context, threshold-gated insights, Bettor's Edge evidence)", "description": "`MatchupDna`. Each side resolves its own snapshot (`meta.resolved_as_of: {a,b}`). `insights[]` are emitted only when the thresholds in `meta.insight_rules` are met (documented in docs/fight_dna_api.md); otherwise the missing sample is named in `warnings[]`. Never from `insufficient` metrics. `bettors_edge_evidence[]` mirrors the insights one-to-one and is evidence only, never a pick. `404 dna_not_available` when neither fighter has a snapshot; `400 invalid_matchup` for identical ids.\n\n**Plan:** Ultra and above. **Origin:** PBE_DERIVED.", "tags": [ "Matchup DNA" ], "parameters": [ { "name": "fighterA", "in": "path", "required": true, "schema": { "type": "string" }, "description": "UUID, UFCStats id, or ESPN athlete id." }, { "name": "fighterB", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/matchups/ec94d296-2db3-4e0d-be6a-46de4f480672/9a3b2a15-27d8-4554-9217-42ef2dd5d25c/dna)", "value": { "ok": true, "data": { "fighters": [ { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "nickname": null, "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "slug_id": "3093653", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "stance": "ORTHODOX", "is_active": true }, { "id": "9a3b2a15-27d8-4554-9217-42ef2dd5d25c", "name": "Dricus Du Plessis", "nickname": "Stilknocks", "ufcstats_id": "0d7b51c9d2649a6e", "espn_athlete_id": "3166126", "slug_id": "3166126", "record_w": 24, "record_l": 3, "record_d": 0, "record_nc": 0, "primary_image": { "id": "e58546e6-fab5-4dca-b24c-5a9773398670", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/9a3b2a15-27d8-4554-9217-42ef2dd5d25c/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/9a3b2a15-27d8-4554-9217-42ef2dd5d25c/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/9a3b2a15-27d8-4554-9217-42ef2dd5d25c/thumb.jpg", "author": "User:Philippe3017", "license": "CC0", "source_url": "https://commons.wikimedia.org/wiki/File:IMG-Dricus-Duplessis(cropped).jpg", "kind": "wikimedia", "attribution_text": "User:Philippe3017, CC0, via Wikimedia Commons", "rights_label": "CC0" }, "stance": "SWITCH", "is_active": true } ], "a": { "as_of_date": "2026-09-06", "sample_bouts": 3, "sample_rounds": 8, "coverage_status": "low", "…": "full snapshot subset omitted from this example" }, "b": { "as_of_date": "2026-09-06", "sample_bouts": 3, "sample_rounds": 5, "coverage_status": "low", "…": "full snapshot subset omitted from this example" }, "comparisons": [ { "key": "sig_landed_per_min", "label": "Sig. strikes landed / min", "unit": "per_min", "family": "striking", "higher_is_better": true, "mismatch": null, "min_abs_delta": null, "a": { "unit": "per_min", "value": 6.2327, "origin": "pbe_derived", "numerator": 233, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_landed_per_min", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "b": { "unit": "per_min", "value": 5.44, "origin": "pbe_derived", "numerator": 136, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "sig_landed_per_min", "denominator": 1500, "sample_bouts": 1, "sample_rounds": 5, "sample_seconds": 1500, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "delta": 0.7927, "direction": "a", "comparable": true, "min_confidence": "low" }, { "key": "sig_absorbed_per_min", "label": "Sig. strikes absorbed / min", "unit": "per_min", "family": "striking", "higher_is_better": false, "mismatch": null, "min_abs_delta": null, "a": { "unit": "per_min", "value": 4.0927, "origin": "pbe_derived", "numerator": 153, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_absorbed_per_min", "denominator": 2243, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "b": { "unit": "per_min", "value": 3.68, "origin": "pbe_derived", "numerator": 92, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "sig_absorbed_per_min", "denominator": 1500, "sample_bouts": 1, "sample_rounds": 5, "sample_seconds": 1500, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "delta": 0.4127, "direction": "a", "comparable": true, "min_confidence": "low" }, { "key": "sig_accuracy", "label": "Sig. strike accuracy", "unit": "ratio", "family": "striking", "higher_is_better": true, "mismatch": null, "min_abs_delta": null, "a": { "unit": "ratio", "value": 0.4213, "origin": "pbe_derived", "numerator": 233, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_accuracy", "denominator": 553, "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "b": { "unit": "ratio", "value": 0.4982, "origin": "pbe_derived", "numerator": 136, "as_of_date": "2026-09-06", "confidence": "low", "metric_key": "sig_accuracy", "denominator": 273, "sample_bouts": 1, "sample_rounds": 5, "sample_seconds": 1500, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "delta": -0.0769, "direction": "b", "comparable": true, "min_confidence": "low" } ], "stance_context": { "a_stance": "ORTHODOX", "b_stance": "SWITCH", "context": "switch_involved", "…": "split blocks omitted from this example" }, "insights": [ { "key": "a_pace_retention_r3_vs_r1", "label": "Sean Strickland R3 pace retention", "value": 2.5884, "unit": "ratio", "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "confidence": "medium", "direction": "contextual", "side": "a", "metric_keys": [ "pace_retention_r3_vs_r1" ], "explanation": "Sean Strickland kept 259% of round-one significant-strike attempt pace into round three across 2 bouts / 4 rounds / 17.4 min of stat-covered fights as of 2026-09-06.", "origin": "pbe_derived" }, { "key": "a_finish_rate", "label": "Sean Strickland finish rate", "value": 0.5, "unit": "ratio", "sample_bouts": 2, "sample_rounds": 8, "sample_seconds": 2243, "confidence": "low", "direction": "contextual", "side": "a", "metric_keys": [ "finish_rate" ], "explanation": "50% of Sean Strickland's 2 UFC wins came by finish (0 KO/TKO, 0 submission), PBE-derived from canonical results as of 2026-09-06.", "origin": "pbe_derived" } ], "warnings": [ "Sean Strickland vs switch-stance opponents: 1 appearance, confidence low; needs >= 3 appearances and confidence >= low. No stance insight emitted.", "Dricus Du Plessis vs orthodox opponents: 2 appearances, confidence low; needs >= 3 appearances and confidence >= low. No stance insight emitted.", "Dricus Du Plessis pace_retention_r3_vs_r1: confidence low (1 bout / 2 rounds / 10.0 min); needs >= 2 stat-covered bouts and confidence >= low. No pace insight emitted.", "Control seconds / takedown: Sean Strickland confidence medium (2 bouts / 8 rounds / 37.4 min); Dricus Du Plessis confidence low (1 bout / 5 rounds / 25.0 min). Both sides need confidence >= low; no grappling mismatch insight emitted." ], "bettors_edge_evidence": [ { "key": "a_pace_retention_r3_vs_r1", "label": "Sean Strickland R3 pace retention", "value": 2.5884, "unit": "ratio", "side": "a", "direction": "contextual", "sample": "2 bouts / 4 rounds / 17.4 min", "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1043, "confidence": "medium", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "explanation": "Sean Strickland kept 259% of round-one significant-strike attempt pace into round three across 2 bouts / 4 rounds / 17.4 min of stat-covered fights as of 2026-09-06." } ], "origin": "pbe_derived", "note": "Fight DNA is PBE-derived evidence with explicit samples and confidence. It is not a pick, price or probability." }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "d93a62d5-bfc9-4f92-9599-0d12b3704898", "requested_as_of": null, "resolved_as_of": { "a": "2026-09-06", "b": "2026-09-06" }, "definition_version": 1, "insight_rules": { "version": 1, "min_confidence": "low", "stance_history": { "min_appearances": 3, "min_confidence": "low" }, "stance_finish_rate": { "min_appearances": 3, "min_confidence": "low", "note": "finish_rate MetricObject of the split must itself be >= low (registry min 2 wins)" }, "pace_retention": { "metric": "pace_retention_r3_vs_r1", "min_bouts": 2, "min_confidence": "low" }, "pace_retention_mismatch": { "metric": "pace_retention_r3_vs_r1", "min_bouts": 2, "min_confidence": "low", "min_abs_delta": 0.1 }, "target_share_mismatch": { "metrics": [ "head_attack_share", "body_attack_share", "leg_attack_share" ], "min_confidence": "low", "min_abs_delta": 0.1 }, "phase_share_mismatch": { "metrics": [ "distance_attack_share", "clinch_attack_share", "ground_attack_share" ], "min_confidence": "low", "min_abs_delta": 0.1 }, "grappling_mismatch": { "min_confidence": "low", "min_abs_delta": { "td_attempts_per_15": 1, "td_accuracy": 0.1, "control_seconds_per_td": 30, "sub_attempts_per_15": 0.5 } }, "finish_rate": { "metric": "finish_rate", "min_confidence": "low" } }, "comparisons": 18, "comparable": 17, "insights": 3, "warnings": 4, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "origin_label": "PBE DERIVED", "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "matchup_dna", "x-plan": "ultra", "x-feature": "dna_matchup", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": false, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/results": { "get": { "summary": "List completed bout results with bout/event context", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/results?limit=2)", "value": { "ok": true, "data": [ { "bout_id": "f1b4d094-6c94-4769-b815-84be1cd7313d", "winner_id": "c66c4189-2a2e-4a64-a688-d2b77e7ee01c", "method": "DEC_U", "method_raw": "Decision - Unanimous", "round": 3, "time_sec": 300, "time_format": "3 Rnd (5-5-5)", "referee": "Gasper Oliver", "judge_1": "Jon Bilyk", "judge_2": "Maimunah Querido", "judge_3": "Tony Tamburrino", "scorecards": [ { "judge": "Jon Bilyk", "score": "27-30" }, { "judge": "Maimunah Querido", "score": "27-30" }, { "judge": "Tony Tamburrino", "score": "27-30" } ], "finish_detail": null, "result_source": "ufcstats", "has_stats": true, "captured_at": "2026-09-07T15:12:36.958409+00:00", "bout": { "id": "f1b4d094-6c94-4769-b815-84be1cd7313d", "ufcstats_id": "d078e9046aa86307", "espn_competition_id": null, "event_id": "48934126-83b1-4736-b4ca-6cdd4446d951", "weight_class": "FLYWEIGHT", "weight_class_raw": "Women's Flyweight", "is_womens": true, "is_title": false, "scheduled_rounds": 3, "card_position": null, "bout_order": 4, "status": "complete", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "c66c4189-2a2e-4a64-a688-d2b77e7ee01c", "dob": "1992-05-15", "name": "Wang Cong", "stance": "SOUTHPAW", "nickname": "The Joker", "reach_in": 65.5, "record_d": 0, "record_l": 1, "record_w": 10, "height_in": 66, "is_active": true, "record_nc": 0, "weight_lbs": 125, "ufcstats_id": "2997e7fe3c9d3d4a", "espn_athlete_id": "4215200" }, "fighter_b": { "id": "96f07308-7d38-458b-afd9-69cd292c9a77", "dob": "1994-01-26", "name": "Ariane da Silva", "stance": "ORTHODOX", "nickname": "Queen of Violence", "reach_in": 67, "record_d": 0, "record_l": 11, "record_w": 17, "height_in": 66, "is_active": null, "record_nc": 0, "weight_lbs": 125, "ufcstats_id": "6551c64fbcd1a467", "espn_athlete_id": null }, "result": { "round": 3, "method": "DEC_U", "bout_id": "f1b4d094-6c94-4769-b815-84be1cd7313d", "judge_1": "Jon Bilyk", "judge_2": "Maimunah Querido", "judge_3": "Tony Tamburrino", "referee": "Gasper Oliver", "time_sec": 300, "has_stats": true, "winner_id": "c66c4189-2a2e-4a64-a688-d2b77e7ee01c", "method_raw": "Decision - Unanimous", "scorecards": [ { "judge": "Jon Bilyk", "score": "27-30" }, { "judge": "Maimunah Querido", "score": "27-30" }, { "judge": "Tony Tamburrino", "score": "27-30" } ], "captured_at": "2026-09-07T15:12:36.958409+00:00", "time_format": "3 Rnd (5-5-5)", "finish_detail": null, "result_source": "ufcstats" }, "event": { "id": "48934126-83b1-4736-b4ca-6cdd4446d951", "city": "Newark", "name": "UFC 316: Dvalishvili vs. O'Malley 2", "venue": "Prudential Center", "is_ppv": null, "region": "New Jersey", "country": "USA", "commission": null, "event_date": "2025-06-07", "updated_at": "2026-09-06T13:55:19.059327+00:00", "card_status": "complete", "ufcstats_id": "18c49685296c60e6", "espn_event_id": "600053672" } } }, { "bout_id": "0252e8f4-9a02-4d44-93cf-83c0934f3233", "winner_id": "bd6b1d04-ba2d-427e-b03b-d27276f6e90d", "method": "DEC_U", "method_raw": "Decision - Unanimous", "round": 3, "time_sec": 300, "time_format": "3 Rnd (5-5-5)", "referee": "Lukasz Bosacki", "judge_1": "Ben Cartlidge", "judge_2": "Eric Colon", "judge_3": "Darryl Ransom", "scorecards": [ { "judge": "Ben Cartlidge", "score": "27-30" }, { "judge": "Eric Colon", "score": "27-30" }, { "judge": "Darryl Ransom", "score": "27-30" } ], "finish_detail": null, "result_source": "ufcstats", "has_stats": true, "captured_at": "2026-09-07T15:08:00.143305+00:00", "bout": { "id": "0252e8f4-9a02-4d44-93cf-83c0934f3233", "ufcstats_id": "2bfc0212f2cae65b", "espn_competition_id": null, "event_id": "d24a7c8b-8b3b-48c9-b4f1-ac3bc5b26310", "weight_class": "BANTAMWEIGHT", "weight_class_raw": "Women's Bantamweight", "is_womens": true, "is_title": false, "scheduled_rounds": 3, "card_position": null, "bout_order": 3, "status": "complete", "replaced_bout_id": null, "short_notice_days": null, "fighter_a": { "id": "bd6b1d04-ba2d-427e-b03b-d27276f6e90d", "dob": "1998-12-30", "name": "Klaudia Sygula", "stance": "ORTHODOX", "nickname": null, "reach_in": 69, "record_d": 0, "record_l": 2, "record_w": 8, "height_in": 68, "is_active": null, "record_nc": 0, "weight_lbs": 135, "ufcstats_id": "9f5e3c20ce40b344", "espn_athlete_id": null }, "fighter_b": { "id": "fd70809a-f906-48c2-ac6e-f6fa71ffcdfa", "dob": "1990-06-27", "name": "Irina Alekseeva", "stance": "ORTHODOX", "nickname": "Russian Ronda", "reach_in": 67, "record_d": 0, "record_l": 4, "record_w": 5, "height_in": 68, "is_active": true, "record_nc": 0, "weight_lbs": 135, "ufcstats_id": "103e2e33a60683e1", "espn_athlete_id": "4711407" }, "result": { "round": 3, "method": "DEC_U", "bout_id": "0252e8f4-9a02-4d44-93cf-83c0934f3233", "judge_1": "Ben Cartlidge", "judge_2": "Eric Colon", "judge_3": "Darryl Ransom", "referee": "Lukasz Bosacki", "time_sec": 300, "has_stats": true, "winner_id": "bd6b1d04-ba2d-427e-b03b-d27276f6e90d", "method_raw": "Decision - Unanimous", "scorecards": [ { "judge": "Ben Cartlidge", "score": "27-30" }, { "judge": "Eric Colon", "score": "27-30" }, { "judge": "Darryl Ransom", "score": "27-30" } ], "captured_at": "2026-09-07T15:08:00.143305+00:00", "time_format": "3 Rnd (5-5-5)", "finish_detail": null, "result_source": "ufcstats" }, "event": { "id": "d24a7c8b-8b3b-48c9-b4f1-ac3bc5b26310", "city": "Baku", "name": "UFC Fight Night: Hill vs. Rountree Jr.", "venue": "Baku Crystal Hall", "is_ppv": null, "region": null, "country": "Azerbaijan", "commission": null, "event_date": "2025-06-21", "updated_at": "2026-09-06T13:55:23.346591+00:00", "card_status": "complete", "ufcstats_id": "400c7b43c86d27d3", "espn_event_id": "600053795" } } } ], "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "2225ef16-af1a-44c0-afa4-541bfc992826", "count": 2, "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "results", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/rankings": { "get": { "summary": "Verified official UFC rankings (ufc.com snapshot)", "description": "Served from the `ufc_rankings` table when migration 003 is applied and populated, otherwise from the Storage snapshot written by the same ingest (`meta.store` says which). Divisions are in official page order; entries are ordered by rank (competition ranking, ties are real). `fighter` is the linked `{id, name, slug_id}` identity or null when the alias resolver could not link unambiguously. Returns `503 rankings_not_available` with `data: null` when no store exists. Never synthesized.\n\n**Plan:** Developer and above. **Origin:** SOURCE_FACT.", "parameters": [ { "name": "division", "in": "query", "description": "Division key filter (e.g. MIDDLEWEIGHT, P4P, light-heavyweight)", "schema": { "type": "string" } }, { "name": "womens", "in": "query", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/rankings?division=MIDDLEWEIGHT)", "value": { "ok": true, "data": { "source": "ufc.com official rankings", "source_url": "https://www.ufc.com/rankings", "snapshot_date": "2026-09-06", "captured_at": "2026-09-06T16:10:07.916+00:00", "divisions": [ { "key": "MIDDLEWEIGHT", "label": "Middleweight", "is_womens": false, "is_p4p": false, "champion": { "name": "Sean Strickland", "ufc_slug": "sean-strickland", "fighter_id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "fighter": { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "name": "Sean Strickland", "slug_id": "3093653" } }, "entries": [ { "rank": 1, "name": "Khamzat Chimaev", "ufc_slug": "khamzat-chimaev", "fighter_id": "82f23ba8-2053-4f0f-88e3-8216893e2f28", "change": 0, "is_new": false, "fighter": { "id": "82f23ba8-2053-4f0f-88e3-8216893e2f28", "name": "Khamzat Chimaev", "slug_id": "4684751" } }, { "rank": 2, "name": "Dricus Du Plessis", "ufc_slug": "dricus-du-plessis", "fighter_id": "9a3b2a15-27d8-4554-9217-42ef2dd5d25c", "change": 0, "is_new": false, "fighter": { "id": "9a3b2a15-27d8-4554-9217-42ef2dd5d25c", "name": "Dricus Du Plessis", "slug_id": "3166126" } }, { "rank": 3, "name": "Nassourdine Imavov", "ufc_slug": "nassourdine-imavov", "fighter_id": "5c028189-a57d-45ff-a868-f86a724b94df", "change": 0, "is_new": false, "fighter": { "id": "5c028189-a57d-45ff-a868-f86a724b94df", "name": "Nassourdine Imavov", "slug_id": "4690539" } } ] } ] }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "9d06f3ab-a250-4eca-83b2-d8d3a60127cf", "store": "table", "divisions": 1, "division": "MIDDLEWEIGHT", "womens": null, "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "tags": [ "Core" ], "operationId": "rankings", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/news": { "get": { "summary": "List published PropBetEdge UFC articles with resolved hero media and a compact analysis_summary", "description": "Every row carries `analysis_summary` (`AnalysisSummary` or null). The raw `fact_block`, the full `analysis` block and `body_md` are never on list rows. `story_class` filters on the editorial fact block's `story_class` (v2 blocks only); `story_type` remains the column filter. `meta.with_analysis` counts rows with a summary.\n\n**Plan:** Developer and above. **Origin:** EDITORIAL.", "parameters": [ { "name": "story_type", "in": "query", "schema": { "type": "string", "enum": [ "card_change", "rankings", "fight_preview", "weigh_in", "results", "line_move", "external" ] } }, { "name": "story_class", "in": "query", "schema": { "type": "string", "enum": [ "main_event_preview", "main_card_preview", "prelim_preview", "event_preview", "results", "card_change", "rankings", "external" ] } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0, "default": 0 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/news?limit=2)", "value": { "ok": true, "data": [ { "id": "7ed289ab-c2d5-4230-9036-e420ffd15131", "slug": "mma-divisional-rankings-upset-ko-boosts-song-yadong-at-bantamweight", "headline": "Song Yadong’s Aug. 29 KO win is the evidence behind ESPN MMA’s bantamweight rankings update", "dek": "ESPN MMA’s rankings item names Song Yadong and Tatsuro Taira; PropBetEdge records show Yadong coming off a second-round KO/TKO win over Umar Nurmagomedov, while Taira’s latest listed result is a fifth-round KO/TKO loss to Joshua Van.", "story_type": "external", "status": "published", "hero_image_ref": null, "hero_credit": null, "fighter_ids": [ "a9a7e9fd-e128-4b7e-949a-4d75b2e00331", "826104d2-9067-466a-9d1c-303813781395" ], "bout_id": null, "event_id": null, "published_at": "2026-09-06T13:47:35.532+00:00", "updated_at": "2026-09-07T00:33:36.444+00:00", "hero_image_url": null, "hero_image": null, "analysis_summary": null }, { "id": "aa42bad3-1904-479f-97f0-a8cd48055e15", "slug": "ufc-fight-night-hooker-vs-parnasse-2026-09-05-results", "headline": "UFC Fight Night: Hooker vs. Parnasse results: Salahdine Parnasse stops Dan Hooker in round 1", "dek": "Salahdine Parnasse finished Dan Hooker with punches at 2:35 of round 1 in Paris. The result adds a finish to Parnasse’s UFC archive, extends Hooker’s recent losing run and reshapes how distance, method and round markets should be read next time.", "story_type": "results", "status": "published", "hero_image_ref": "8d8dfedd-cce5-4e34-aa31-a4d346616dec", "hero_credit": { "author": "ZACK", "license": "CC BY 3.0", "source_url": "https://commons.wikimedia.org/wiki/File:ParnasseMMA2023.png" }, "fighter_ids": [ "5c8d6aaf-28fb-49ad-8ffd-4f161c508728", "ebc1b218-f1fb-4f18-bd29-a1690910499f", "14a47802-4922-4156-ad28-6d3e35666485", "b338d8f1-d9c0-4652-a6bd-de75704ffcee", "940796ad-7733-4992-95c0-91031101fef7", "5e4ce93e-f8c5-464c-9100-6ba20484af9f", "45866b70-3f63-4996-8ec4-416e40b4c6b6", "1859d7c4-45a8-4cd5-9988-f9c867a9774f", "65a8e288-aa40-402b-b15c-377bb93ddbc1", "6d412d00-13c6-4d7b-b1c7-7b7f03323452", "ca7c0b28-56b6-4980-9a21-f81b35d5c134", "b85dbabc-1300-485e-9171-8d54389608dd", "7f0ff8e2-104c-43f5-a7df-f44af76a0b58", "5c8b7384-316f-48e9-b5b8-12d932f24ac1", "bc6d359a-c6e7-40f3-8398-8ec723105090", "7752c8fc-23f6-4d72-9a46-8ff1b8d149cf", "27ef465b-564f-40eb-83fd-ef37679cd087", "a9ba404e-8fbb-40cc-a23b-0a30a2cb7ba3", "d5f8d991-996f-463f-acee-618863d29c84", "53b2b5aa-e831-40a8-b5e9-efb211312c5c", "1a857166-616a-43aa-a30e-3a425d926115", "a54eb74e-2ef5-42e3-a3f8-5fb910bcb98c", "5cd8d0d8-8769-4a59-8851-798523aeaff5", "1d8d7841-1ece-4716-90fa-ab3cf821fb1d", "230dff12-4ef9-4070-8a66-2b10b0bc8e42", "cec1b908-aa6d-4e47-8f77-5c98dc0c10f9", "a223c4bc-17b9-4d57-9d8e-7f54dbd668a8", "56a92061-ab60-49b8-9852-c6420caf5ad0" ], "bout_id": "cd8c325b-d342-4606-9269-94f4cce877a2", "event_id": "0edba201-82f9-4525-85e4-3034b7bc09f7", "published_at": "2026-09-06T13:47:35.039+00:00", "updated_at": "2026-09-07T00:24:24.961+00:00", "hero_image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ebc1b218-f1fb-4f18-bd29-a1690910499f/portrait.jpg", "hero_image": { "id": "8d8dfedd-cce5-4e34-aa31-a4d346616dec", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ebc1b218-f1fb-4f18-bd29-a1690910499f/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ebc1b218-f1fb-4f18-bd29-a1690910499f/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ebc1b218-f1fb-4f18-bd29-a1690910499f/thumb.jpg", "author": "ZACK", "license": "CC BY 3.0", "source_url": "https://commons.wikimedia.org/wiki/File:ParnasseMMA2023.png", "kind": "wikimedia", "attribution_text": "ZACK, CC BY 3.0, via Wikimedia Commons", "rights_label": "CC BY 3.0", "fighter_id": "ebc1b218-f1fb-4f18-bd29-a1690910499f", "ref": "8d8dfedd-cce5-4e34-aa31-a4d346616dec" }, "analysis_summary": { "impact_score": 4, "markets": [ "fight_goes_distance", "total_rounds", "method_of_victory", "round_betting" ], "odds_status": "unavailable", "model_status": "unavailable", "story_class": "results" } } ], "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "06b6f804-1341-4d2a-90e7-3fb3a8843678", "count": 2, "total": 28, "offset": 0, "story_type": null, "story_class": null, "with_hero": 1, "with_analysis": 1, "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Editorial" ], "operationId": "news", "x-plan": "developer", "x-feature": "editorial", "x-origin": "EDITORIAL", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/articles/{slug}": { "get": { "summary": "Get a published UFC article with resolved hero media and the bettor-angle analysis", "description": "Adds `analysis` (`ArticleAnalysis`) copied field-for-field from `fact_block` when `fact_block.version >= 2`, else null — never synthesized from prose; `analysis_summary` (`AnalysisSummary` or null); `word_count` and `reading_minutes` (220 wpm, minimum 1) computed from `body_md`. The raw `fact_block` stays on detail for provenance. Odds and model fields inside the analysis are `unavailable` until verified structured data exists; `impact_score` is editorial analysis, not a price or probability.\n\n**Plan:** Developer and above. **Origin:** EDITORIAL.", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Editorial" ], "operationId": "article", "x-plan": "developer", "x-feature": "editorial", "x-origin": "EDITORIAL", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/wire": { "get": { "summary": "Global live wire — attributed newsroom headlines, deduped, newest first, mapped to internal pages", "description": "Source of truth is `ufc_news_items` joined to `ufc_news_sources`. Items are newest first; near-identical headlines from several feeds are collapsed (normalized title: lowercase, punctuation and stopwords stripped, first 60 chars) keeping the earliest-published copy. `taxonomy` is the first label string (or null); the full taxonomy object is under `taxonomy_detail`. `internal_url` is `/news/` when a published PropBetEdge article shares the bout, shares the event plus a fighter, or cites the item in `sources`; else `/fights/-vs--` for a linked bout; else `/events/`; else `/fighters/-` when exactly one fighter is linked; else null (link the attributed `source_url` instead). Titles and summaries are never fabricated. Responses carry `Cache-Control: public, max-age=15, s-maxage=30, stale-while-revalidate=120` and CORS `*` so the rail can poll from the browser.\n\n**Plan:** Enterprise and above. **Origin:** THIRD_PARTY_LINK.", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Editorial" ], "operationId": "wire", "x-plan": "enterprise", "x-feature": "wire", "x-origin": "THIRD_PARTY_LINK", "x-plans": { "developer": false, "pro": false, "ultra": false, "scale": false, "enterprise": true, "first_party": true } } }, "/v1/ufc/search": { "get": { "summary": "Search fighters (with primary_image + slug_id), events, and articles (with hero media)", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 2, "maxLength": 100 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 25, "default": 10 } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/search?q=strickland&limit=3)", "value": { "ok": true, "data": { "q": "strickland", "fighters": [ { "id": "ec94d296-2db3-4e0d-be6a-46de4f480672", "ufcstats_id": "0d8011111be000b2", "espn_athlete_id": "3093653", "name": "Sean Strickland", "nickname": null, "dob": "1991-02-27", "height_in": 73, "reach_in": 76, "weight_lbs": 185, "stance": "ORTHODOX", "record_w": 31, "record_l": 7, "record_d": 0, "record_nc": 0, "is_active": true, "primary_image": { "id": "006e6554-f441-4892-8a49-30409d01e52e", "image_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/portrait.jpg", "card_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/card.jpg", "thumb_url": "https://tkmlnhmylqnttmnsnief.supabase.co/storage/v1/object/public/ufc-media/fighters/ec94d296-2db3-4e0d-be6a-46de4f480672/thumb.jpg", "author": "MMAnytt", "license": "CC BY-SA 4.0", "source_url": "https://commons.wikimedia.org/wiki/File:Sean_Strickland_at_UFN_200.png", "kind": "wikimedia", "attribution_text": "MMAnytt, CC BY-SA 4.0, via Wikimedia Commons", "rights_label": "CC BY-SA 4.0" }, "slug_id": "3093653" } ], "events": [ { "id": "de5d4510-50c9-4989-b6e6-4c7ca52f0ede", "ufcstats_id": "9eedac48b497de5a", "espn_event_id": "600058947", "name": "UFC 328: Chimaev vs. Strickland", "event_date": "2026-05-09", "venue": "Prudential Center", "city": "Newark", "region": "NJ", "country": "USA", "commission": null, "is_ppv": null, "card_status": "complete", "updated_at": "2026-09-07T06:01:34.903+00:00" }, { "id": "ce387df8-d8fc-4a1f-b644-3628e803cb16", "ufcstats_id": "79ab17db3b40831a", "espn_event_id": "600057329", "name": "UFC Fight Night: Strickland vs. Hernandez", "event_date": "2026-02-21", "venue": "Toyota Center (Houston)", "city": "Houston", "region": "TX", "country": "USA", "commission": null, "is_ppv": null, "card_status": "complete", "updated_at": "2026-09-07T06:01:12.886+00:00" }, { "id": "4da5492f-1192-402d-9760-0647a385d392", "ufcstats_id": "e6015889f50075d2", "espn_event_id": "600050481", "name": "UFC 312: Du Plessis vs. Strickland 2", "event_date": "2025-02-08", "venue": "Qudos Bank Arena", "city": "Sydney", "region": "New South Wales", "country": "Australia", "commission": null, "is_ppv": null, "card_status": "complete", "updated_at": "2026-09-06T13:54:46.369281+00:00" } ], "articles": [] }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "ed59255d-df96-4784-8665-ffac80262cf9", "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "search", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/counts": { "get": { "summary": "Dataset counts (fighters, events, bouts, results, round_stat_rows/rounds, articles, images, fighters_with_media)", "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/counts)", "value": { "ok": true, "data": { "fighters": 1345, "events": 898, "bouts": 1489, "results": 1404, "round_stat_rows": 3598, "articles": 28, "images": 188, "fighters_with_media": 188, "rounds": 3598 }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "265964d2-def8-4ae6-be60-4082f3bc8cf8", "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" } }, "tags": [ "Core" ], "operationId": "counts", "x-plan": "developer", "x-feature": "core", "x-origin": "SOURCE_FACT", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true }, "description": "**Plan:** Developer and above. **Origin:** SOURCE_FACT." } }, "/v1/ufc/videos": { "get": { "summary": "Published official videos (allowlisted channels), newest first", "description": "Rows are `Video` (metadata only; `embed_url` is built at render time from the provider id on the privacy-enhanced YouTube domain, nothing is rehosted). Only `link_status = published` rows are ever returned; review / rejected links never leave the database. `fighter_id` must be a UUID; `event_id` / `bout_id` accept UUID, UFCStats or ESPN ids. `503 videos_not_available` while migration 006 is not applied.\n\n**Plan:** Developer and above. **Origin:** THIRD_PARTY_LINK.", "tags": [ "Media" ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "type", "in": "query", "schema": { "$ref": "#/components/schemas/VideoType" } }, { "name": "fighter_id", "in": "query", "schema": { "type": "string", "format": "uuid" } }, { "name": "event_id", "in": "query", "schema": { "type": "string" } }, { "name": "bout_id", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/videos?limit=2)", "value": { "ok": true, "data": [ { "id": "c098d596-2111-48da-b1e2-e7b459a4da11", "provider": "youtube", "provider_video_id": "IulA4gBPp5M", "url": "https://www.youtube.com/watch?v=IulA4gBPp5M", "embed_url": "https://www.youtube-nocookie.com/embed/IulA4gBPp5M", "thumbnail_url": "https://i2.ytimg.com/vi/IulA4gBPp5M/hqdefault.jpg", "title": "Rafael Fiziev x Mauricio Ruffy | LUTA COMPLETA | Crypto.com UFC 331", "published_at": "2026-09-06T21:00:09+00:00", "duration_sec": null, "embeddable": true, "live_broadcast_state": null, "video_type": "full_fight", "video_type_label": "Full fight", "channel": { "id": "UCk8XGxi7fsTqQQRVq9LSraw", "name": "UFC Brasil", "verified": true }, "links": { "event_id": "221ca353-f623-4b66-98aa-3a504a418236", "bout_id": null, "article_id": null, "fighter_ids": [ "17563ab2-dbac-4366-861f-917628a0a4b1", "38d76024-e211-4429-bb77-0f6e3c2016cc" ] }, "resolver_confidence": "medium", "attribution": "YouTube · UFC Brasil", "captured_at": "2026-09-07T01:29:49.806359+00:00", "updated_at": "2026-09-07T01:29:46.802+00:00" }, { "id": "c7e07888-bd3e-4391-ada6-a5960050bf13", "provider": "youtube", "provider_video_id": "cs-T1Qgb-sk", "url": "https://www.youtube.com/watch?v=cs-T1Qgb-sk", "embed_url": "https://www.youtube-nocookie.com/embed/cs-T1Qgb-sk", "thumbnail_url": "https://i4.ytimg.com/vi/cs-T1Qgb-sk/hqdefault.jpg", "title": "Noche UFC: Silva vs Delgado - September 12th | Fight Promo", "published_at": "2026-09-06T17:30:29+00:00", "duration_sec": null, "embeddable": true, "live_broadcast_state": null, "video_type": "fight_preview", "video_type_label": "Fight preview", "channel": { "id": "UCvgfXK4nTYKudb0rFR6noLA", "name": "UFC", "verified": true }, "links": { "event_id": "1d0b22df-81e7-4e5b-8fa5-8e5d03c24c52", "bout_id": null, "article_id": null, "fighter_ids": [ "55ef67ad-88fe-4f7a-b4cb-dc9a10c12feb", "eed368a5-484b-412f-9d2c-a4fd6d24d019" ] }, "resolver_confidence": "medium", "attribution": "YouTube · UFC", "captured_at": "2026-09-07T01:29:49.112112+00:00", "updated_at": "2026-09-07T01:29:46.802+00:00" } ], "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "d8f228dd-c396-4ad7-90df-6563d94af75c", "count": 2, "total": 63, "limit": 2, "type": null, "fighter_id": null, "event_id": null, "bout_id": null, "published_only": true, "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "videos", "x-plan": "developer", "x-feature": "video_metadata", "x-origin": "THIRD_PARTY_LINK", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/dna/metrics": { "get": { "summary": "Fight DNA metric registry (active, public rows grouped by family)", "description": "`data.metrics[]` and `data.families{}` are `MetricDefinition` rows from `ufc_dna_metric_definitions` (`active=true`, `public=true`, requested `definition_version`), plus `origin_labels`, `confidence_tiers` and `as_of_semantics`. Every Fight DNA route shares the cache policy `public, max-age=60, s-maxage=300, stale-while-revalidate=900`. `503 dna_not_available` while migration 004 is not applied (`error.detail.reason = schema_not_applied`).\n\n**Plan:** Developer and above. **Origin:** PBE_DERIVED.", "tags": [ "Fight DNA" ], "parameters": [ { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/dna/metrics)", "value": { "ok": true, "data": { "definition_version": 1, "origin": "pbe_derived", "origin_labels": { "pbe_derived": "PBE DERIVED", "source": "SOURCE", "licensed": "LICENSED", "model": "MODEL" }, "confidence_tiers": { "insufficient": "sample below the metric's registry minimum (min_bouts / min_rounds / min_seconds); value is null when there is no denominator", "low": "minimum met but sample_bouts < 3 (result metrics) or sample_seconds < 1800 (rate metrics)", "medium": "sample_bouts < 8 (result metrics) or sample_seconds < 5400 (rate metrics)", "high": "sample_bouts >= 8 (result metrics) or sample_seconds >= 5400 (rate metrics)" }, "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "families": { "striking": [ { "metric_key": "body_attack_share", "definition_version": 1, "family": "striking", "display_name": "Body Attack Share", "description": "Body significant-strike attempts divided by all significant-strike attempts.", "unit": "ratio", "formula": "body_att / sig_str_att", "source_families": [ "ufcstats" ], "min_bouts": 1, "min_rounds": 2, "min_seconds": 300, "public": true, "active": true, "updated_at": "2026-09-06T16:09:45.846533+00:00", "origin": "pbe_derived" }, { "metric_key": "clinch_attack_share", "definition_version": 1, "family": "striking", "display_name": "Clinch Attack Share", "description": "Clinch significant-strike attempts divided by all significant-strike attempts.", "unit": "ratio", "formula": "clinch_att / sig_str_att", "source_families": [ "ufcstats" ], "min_bouts": 1, "min_rounds": 2, "min_seconds": 300, "public": true, "active": true, "updated_at": "2026-09-06T16:09:45.846533+00:00", "origin": "pbe_derived" } ], "…": "other families omitted from this example" }, "metrics": [ { "metric_key": "open_stance_record", "definition_version": 1, "family": "stance", "display_name": "Open-Stance Record", "description": "W/L/D/NC when one fighter is listed orthodox and the other southpaw.", "unit": "record", "formula": "aggregate outcomes where stance_context = open", "source_families": [ "espn", "ufcstats" ], "min_bouts": 1, "min_rounds": 0, "min_seconds": 0, "public": true, "active": true, "updated_at": "2026-09-06T16:27:00.088767+00:00", "origin": "pbe_derived" }, { "metric_key": "same_stance_record", "definition_version": 1, "family": "stance", "display_name": "Same-Stance Record", "description": "W/L/D/NC when both listed stances are the same.", "unit": "record", "formula": "aggregate outcomes where stance_context = same", "source_families": [ "espn", "ufcstats" ], "min_bouts": 1, "min_rounds": 0, "min_seconds": 0, "public": true, "active": true, "updated_at": "2026-09-06T16:27:00.088767+00:00", "origin": "pbe_derived" } ] }, "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "bb220d95-bc07-4f1a-b35e-a298ccd51a2c", "count": 60, "families": 6, "definition_version": 1, "access_tier": "public" } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "dna_metrics", "x-plan": "developer", "x-feature": "dna_registry", "x-origin": "PBE_DERIVED", "x-plans": { "developer": true, "pro": true, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } }, "/v1/ufc/dna/query": { "get": { "summary": "Filter current Fight DNA snapshots (or stance splits) by one metric", "description": "North-star filter, e.g. `?metric=pace_retention_r3_vs_r1&min=0.9`. Filters run in PostgREST on the stored MetricObject (`metrics->->value` jsonb ordering, `metrics->->>confidence`); only a fighter's latest snapshot (<= `as_of`) qualifies; the candidate scan is capped at 1000 rows (PostgREST max_rows) (`meta.truncated`). With `stance` the query runs over `ufc_fighter_stance_splits` for that opponent stance and `metric` must be one of finish_rate, ko_rate, sub_rate, sig_diff_per_min, kd_per_15, td_landed_per_15 (registry aliases accepted). Rows are `DnaQueryRow`, sorted by value (`order`, nulls last).\n\n**Plan:** Ultra and above. **Origin:** PBE_DERIVED.", "tags": [ "Fight DNA" ], "parameters": [ { "name": "metric", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^[a-z][a-z0-9_]{1,63}$" } }, { "name": "min", "in": "query", "schema": { "type": "number" } }, { "name": "max", "in": "query", "schema": { "type": "number" } }, { "name": "stance", "in": "query", "schema": { "type": "string", "enum": [ "ORTHODOX", "SOUTHPAW", "SWITCH", "OPEN_STANCE", "SIDEWAYS", "UNKNOWN" ] } }, { "name": "min_confidence", "in": "query", "schema": { "type": "string", "enum": [ "insufficient", "low", "medium", "high" ], "default": "low" } }, { "name": "min_appearances", "in": "query", "description": "Stance-split mode only.", "schema": { "type": "integer", "minimum": 0, "default": 1 } }, { "name": "active", "in": "query", "schema": { "type": "boolean" } }, { "name": "order", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } }, { "$ref": "#/components/parameters/AsOf" }, { "$ref": "#/components/parameters/DefinitionVersion" } ], "responses": { "200": { "description": "Success envelope `{ ok, data, meta }` — identical to the canonical API.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Upstream-Request-Id": { "$ref": "#/components/headers/X-Upstream-Request-Id" }, "X-API-Version": { "$ref": "#/components/headers/X-API-Version" }, "X-Gateway-Version": { "$ref": "#/components/headers/X-Gateway-Version" }, "X-Plan": { "$ref": "#/components/headers/X-Plan" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Quota-Limit": { "$ref": "#/components/headers/X-Quota-Limit" }, "X-Quota-Remaining": { "$ref": "#/components/headers/X-Quota-Remaining" }, "X-Quota-Reset": { "$ref": "#/components/headers/X-Quota-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" }, "examples": { "live": { "summary": "Live response captured 2026-09-07 (/v1/ufc/dna/query?metric=sig_landed_per_min&min_confidence=medium&limit=3)", "value": { "ok": true, "data": [ { "fighter": { "id": "b5bceb9a-635e-4b9f-8426-ca8ea0339ddf", "name": "Tommy McMillen", "nickname": "Gun", "slug_id": "5212849", "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "metric_key": "sig_landed_per_min", "metric": { "unit": "per_min", "value": 18.6998, "origin": "pbe_derived", "numerator": 326, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_landed_per_min", "denominator": 1046, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 1046, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "origin": "pbe_derived", "sample": { "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 2, "sample_rounds": 4, "sample_seconds": 1046, "coverage_status": "low" } }, { "fighter": { "id": "8e9fb2a2-f378-48c5-88a1-88fa791c59ba", "name": "Ty Miller", "nickname": "Thriller", "slug_id": "5290957", "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "metric_key": "sig_landed_per_min", "metric": { "unit": "per_min", "value": 12.6039, "origin": "pbe_derived", "numerator": 192, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_landed_per_min", "denominator": 914, "sample_bouts": 2, "sample_rounds": 4, "sample_seconds": 914, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "origin": "pbe_derived", "sample": { "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 2, "sample_rounds": 4, "sample_seconds": 914, "coverage_status": "low" } }, { "fighter": { "id": "d917e808-4a1e-4c3d-8957-aa2effba265a", "name": "Brando Peričić", "nickname": "The Balkan Bear", "slug_id": "5293988", "stance": "ORTHODOX", "is_active": true }, "as_of_date": "2026-09-06", "metric_key": "sig_landed_per_min", "metric": { "unit": "per_min", "value": 11.004, "origin": "pbe_derived", "numerator": 137, "as_of_date": "2026-09-06", "confidence": "medium", "metric_key": "sig_landed_per_min", "denominator": 747, "sample_bouts": 3, "sample_rounds": 4, "sample_seconds": 747, "coverage_status": "low", "source_families": [ "ufcstats" ], "definition_version": 1 }, "origin": "pbe_derived", "sample": { "sample_bouts": 3, "sample_completed_bouts": 3, "sample_stat_bouts": 3, "sample_rounds": 4, "sample_seconds": 747, "coverage_status": "low" } } ], "meta": { "api": "PropSports UFC", "version": "2026-09-06.3", "request_id": "458fa56c-a4cb-4e3c-a3fb-8205d6887a38", "mode": "snapshot", "metric": "sig_landed_per_min", "metric_requested": "sig_landed_per_min", "stance": null, "min": null, "max": null, "min_confidence": "medium", "min_appearances": null, "active": null, "order": "desc", "requested_as_of": null, "definition_version": 1, "candidates": 289, "candidates_total": 289, "truncated": false, "matched": 285, "count": 3, "limit": 3, "filter": { "table": "ufc_fighter_dna_snapshots", "value": [], "confidence": "metrics->sig_landed_per_min->>confidence=in.(medium,high)" }, "note": "Filters run in PostgREST on the stored MetricObject (jsonb ordering on ->value, text match on ->>confidence). Only each fighter's latest snapshot qualifies. The candidate scan is capped at 1000 rows; when truncated is true the result set is incomplete. Active filtering happens after the scan.", "as_of_semantics": "as_of_date is exclusive: the snapshot dated D contains bouts with event_date < D, so a bout fought on D is excluded by the snapshot dated D. ?as_of=D resolves to the latest stored snapshot with as_of_date <= D, which therefore never contains a bout fought on or after D.", "origin": "pbe_derived", "access_tier": "public" } } } } } } }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/PlanRequired" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "502": { "$ref": "#/components/responses/UpstreamUnavailable" }, "503": { "$ref": "#/components/responses/Error" } }, "operationId": "dna_query", "x-plan": "ultra", "x-feature": "dna_query", "x-origin": "PBE_DERIVED", "x-plans": { "developer": false, "pro": false, "ultra": true, "scale": true, "enterprise": true, "first_party": true } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "pt_ufc_live__" }, "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } }, "headers": { "X-Request-Id": { "description": "Gateway request id (also in `meta.request_id` on gateway errors).", "schema": { "type": "string", "format": "uuid" } }, "X-Upstream-Request-Id": { "description": "Request id assigned by the canonical UFC API for the forwarded call.", "schema": { "type": "string" } }, "X-API-Version": { "description": "Canonical data-contract version (currently 2026-09-06.3).", "schema": { "type": "string" } }, "X-Gateway-Version": { "description": "Commercial gateway version (currently 2026-09-07.1).", "schema": { "type": "string" } }, "X-Plan": { "description": "Plan the request was authorized under.", "schema": { "type": "string", "enum": [ "developer", "pro", "ultra", "scale", "enterprise", "first_party", "internal" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (or `unlimited`).", "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "description": "Requests remaining in the current minute window.", "schema": { "type": "string" } }, "X-RateLimit-Reset": { "description": "Unix time (seconds) when the minute window resets.", "schema": { "type": "integer" } }, "X-Quota-Limit": { "description": "Included requests for the current calendar month (UTC), or `unlimited`.", "schema": { "type": "string" } }, "X-Quota-Remaining": { "description": "Requests remaining this month.", "schema": { "type": "string" } }, "X-Quota-Reset": { "description": "Unix time (seconds) of the next monthly reset (first of next month, UTC).", "schema": { "type": "integer" } } }, "responses": { "Success": { "description": "Successful normalized UFC API response", "headers": { "X-Request-Id": { "schema": { "type": "string" } }, "X-API-Version": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "Error": { "description": "Explicit API failure or unavailable data surface (data is always null)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "Unauthorized": { "description": "Missing, invalid, expired or revoked API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "api_key_required": { "value": { "ok": false, "data": null, "error": { "code": "api_key_required", "message": "An API key is required. Send `Authorization: Bearer ` or `X-API-Key: `." }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } }, "invalid_api_key": { "value": { "ok": false, "data": null, "error": { "code": "invalid_api_key", "message": "The API key is invalid." }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } }, "api_key_expired": { "value": { "ok": false, "data": null, "error": { "code": "api_key_expired", "message": "The API key has expired.", "detail": { "expires_at": "2026-12-31T00:00:00.000Z" } }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } } } } } }, "PlanRequired": { "description": "The key's plan is not entitled to this endpoint or parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "plan_required": { "value": { "ok": false, "data": null, "error": { "code": "plan_required", "message": "This endpoint requires the pro plan or higher.", "detail": { "required_feature": "dna_fighter", "required_plan": "pro", "current_plan": "developer", "upgrade_url": "https://ufc.proptechusa.ai/pricing" } }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } }, "parameter_gate": { "value": { "ok": false, "data": null, "error": { "code": "plan_required", "message": "Parameter include=stats requires the pro plan or higher.", "detail": { "required_feature": "round_stats_deep", "required_plan": "pro", "current_plan": "developer", "upgrade_url": "https://ufc.proptechusa.ai/pricing", "parameter": { "name": "include", "value": "stats" } } }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } } } } } }, "TooManyRequests": { "description": "Per-minute rate limit or monthly quota exceeded. `Retry-After` is set.", "headers": { "Retry-After": { "schema": { "type": "integer" } }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "rate_limited": { "value": { "ok": false, "data": null, "error": { "code": "rate_limited", "message": "Rate limit of 60 requests per minute exceeded.", "detail": { "retry_after_seconds": 23, "plan": "developer", "upgrade_url": "https://ufc.proptechusa.ai/pricing" } }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } }, "quota_exceeded": { "value": { "ok": false, "data": null, "error": { "code": "quota_exceeded", "message": "Monthly quota of 25000 requests exceeded.", "detail": { "retry_after_seconds": 1209600, "plan": "developer", "upgrade_url": "https://ufc.proptechusa.ai/pricing" } }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } } } } } }, "UpstreamUnavailable": { "description": "The canonical UFC API is unavailable or timed out. Nothing is synthesized; retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }, "examples": { "upstream_unavailable": { "value": { "ok": false, "data": null, "error": { "code": "upstream_unavailable", "message": "The canonical UFC API is unavailable.", "detail": { "upstream": "ufc-api.propbetedge.ai" } }, "meta": { "api": "PropTechUSA UFC Intelligence API", "version": "2026-09-06.3", "gateway_version": "2026-09-07.1", "request_id": "8a1d2c9e-0f3b-4c6a-9e2d-1b7f5a3c4d21" } } } } } } } }, "parameters": { "EntityId": { "name": "id", "in": "path", "required": true, "description": "Internal UUID, 16-character UFCStats ID, or ESPN source ID.", "schema": { "type": "string" } }, "FighterInclude": { "name": "include", "in": "query", "required": false, "description": "Comma-separated additive blocks. Unknown values return 400 invalid_include.", "schema": { "type": "string", "example": "media,ranking,next,history,stats,videos" } }, "CardInclude": { "name": "include", "in": "query", "required": false, "description": "Comma-separated additive blocks (`videos` adds the latest 6 published official videos, or null while migration 006 is unapplied). Unknown values return 400 invalid_include.", "schema": { "type": "string", "example": "media,results,stats,videos" } }, "AsOf": { "name": "as_of", "in": "query", "required": false, "description": "Calendar date (YYYY-MM-DD). Resolves to the latest snapshot with as_of_date <= as_of. Snapshot dates are exclusive (a snapshot dated D contains bouts with event_date < D). Invalid dates are 400 invalid_as_of.", "schema": { "type": "string", "format": "date" } }, "DefinitionVersion": { "name": "version", "in": "query", "required": false, "description": "Fight DNA definition_version (default 1).", "schema": { "type": "integer", "minimum": 1, "maximum": 99, "default": 1 } } }, "schemas": { "PrimaryImage": { "type": "object", "description": "Compact licensed media reference. Null wherever no approved image exists; never fabricated.", "required": [ "image_url", "card_url", "thumb_url", "author", "license", "source_url", "kind" ], "properties": { "id": { "type": [ "string", "null" ], "format": "uuid" }, "image_url": { "type": "string", "format": "uri", "description": "Durable first-party URL: {UFC_IMAGE_BASE_URL}/{r2_key} (portrait, <=1200px long edge)." }, "card_url": { "type": [ "string", "null" ], "format": "uri", "description": "800x1000 attention crop beside the portrait; null for non-portrait keys." }, "thumb_url": { "type": [ "string", "null" ], "format": "uri", "description": "320x400 cover crop beside the portrait; null for non-portrait keys." }, "author": { "type": [ "string", "null" ] }, "license": { "type": [ "string", "null" ] }, "source_url": { "type": [ "string", "null" ], "format": "uri", "description": "Wikimedia Commons file page; render as the credit link." }, "kind": { "type": [ "string", "null" ], "enum": [ "wikimedia", "statcard", "public_domain", "licensed_editorial", "official_press", null ] }, "attribution_text": { "type": [ "string", "null" ], "description": "Rendered credit line from the 006 media registry; null when not recorded." }, "rights_label": { "type": [ "string", "null" ], "description": "e.g. \"CC BY-SA 4.0\", \"Public domain\", \"Licensed (contract #)\"; null when not recorded." } } }, "ImageRef": { "allOf": [ { "$ref": "#/components/schemas/PrimaryImage" }, { "type": "object", "properties": { "r2_key": { "type": "string" }, "fighter_id": { "type": [ "string", "null" ], "format": "uuid" }, "created_at": { "type": [ "string", "null" ], "format": "date-time" } } } ] }, "HeroImage": { "allOf": [ { "$ref": "#/components/schemas/PrimaryImage" }, { "type": "object", "properties": { "fighter_id": { "type": [ "string", "null" ], "format": "uuid" }, "ref": { "type": "string", "description": "The article's hero_image_ref (ufc_images.id or storage key)." } } } ] }, "BettorAngle": { "type": "object", "description": "Editorial bettor-angle analysis from docs/editorial_contract.md. Analysis, labelled as such: impact_score is not a price, probability or pick. odds_status / model_status stay `unavailable` until verified data exists.", "required": [ "impact_score", "markets", "summary", "supporting_facts", "risks", "watch_items", "odds_status", "model_status" ], "properties": { "impact_score": { "type": "integer", "minimum": 1, "maximum": 5, "description": "Editorial betting relevance (1 low, 5 high). Analysis, not a price." }, "markets": { "type": "array", "items": { "type": "string", "enum": [ "moneyline", "fight_goes_distance", "total_rounds", "method_of_victory", "round_betting", "significant_strikes", "takedowns" ] } }, "summary": { "type": "string", "description": "2–5 sentences of analysis." }, "supporting_facts": { "type": "array", "minItems": 1, "items": { "type": "string" }, "description": "Each fact is traceable to matchup/archive fields." }, "risks": { "type": "array", "minItems": 1, "items": { "type": "string" }, "description": "At least one counter-case." }, "watch_items": { "type": "array", "items": { "type": "string" } }, "odds_status": { "type": "string", "enum": [ "unavailable", "snapshot", "live" ], "description": "`unavailable` until verified odds exist in PropBetEdge data." }, "model_status": { "type": "string", "enum": [ "unavailable", "priced" ], "description": "`unavailable` until a real model output exists." } } }, "MarketWatch": { "type": "object", "required": [ "status", "markets", "note" ], "properties": { "status": { "type": "string", "enum": [ "unavailable", "snapshot", "live" ] }, "markets": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" } } }, "FighterFacts": { "type": "object", "description": "Fighter facts as printed in the fact block (percentages as printed, e.g. 42 = 42%); null fields when absent.", "properties": { "fighter_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "nickname": { "type": [ "string", "null" ] }, "slug": { "type": "string", "description": "web fighter slug (slugified name + slug_id)." }, "record": { "type": "object", "properties": { "w": { "type": "integer" }, "l": { "type": "integer" }, "d": { "type": "integer" }, "nc": { "type": "integer" } } }, "age": { "type": [ "integer", "null" ] }, "height_in": { "type": [ "number", "null" ] }, "reach_in": { "type": [ "number", "null" ] }, "stance": { "type": [ "string", "null" ] }, "weight_lbs": { "type": [ "number", "null" ] }, "career": { "type": [ "object", "null" ], "properties": { "slpm": { "type": [ "number", "null" ] }, "str_acc": { "type": [ "number", "null" ] }, "sapm": { "type": [ "number", "null" ] }, "str_def": { "type": [ "number", "null" ] }, "td_avg": { "type": [ "number", "null" ] }, "td_acc": { "type": [ "number", "null" ] }, "td_def": { "type": [ "number", "null" ] }, "sub_avg": { "type": [ "number", "null" ] } } }, "archive": { "type": [ "object", "null" ], "properties": { "fights": { "type": "integer" }, "w": { "type": "integer" }, "l": { "type": "integer" }, "d": { "type": "integer" }, "nc": { "type": "integer" }, "ko": { "type": "integer" }, "sub": { "type": "integer" }, "dec": { "type": "integer" }, "finish_rate": { "type": [ "number", "null" ] }, "rounds_with_stats": { "type": "integer" }, "totals": { "type": "object", "properties": { "sig_l": { "type": "integer" }, "sig_a": { "type": "integer" }, "td_l": { "type": "integer" }, "td_a": { "type": "integer" }, "kd": { "type": "integer" }, "ctrl_sec": { "type": "integer" } } }, "last": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "opponent": { "type": "string" }, "opponent_slug": { "type": [ "string", "null" ] }, "result": { "type": "string" }, "method": { "type": [ "string", "null" ] }, "round": { "type": [ "integer", "null" ] }, "event": { "type": "string" } } } }, "days_since_last": { "type": [ "integer", "null" ] } } } } }, "MatchupFacts": { "type": "object", "required": [ "a", "b", "edges" ], "properties": { "a": { "$ref": "#/components/schemas/FighterFacts" }, "b": { "$ref": "#/components/schemas/FighterFacts" }, "edges": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "favors": { "type": "string", "enum": [ "a", "b" ] }, "delta": { "type": [ "number", "null" ] }, "unit": { "type": [ "string", "null" ] }, "note": { "type": [ "string", "null" ] } } } } } }, "ArticleAnalysis": { "type": "object", "description": "Present on article detail only when fact_block.version >= 2; copied from the stored block, never synthesized.", "required": [ "version", "story_class", "generated_at", "sources", "bettor_angle", "market_watch", "matchup" ], "properties": { "version": { "type": "integer", "minimum": 2 }, "story_class": { "type": [ "string", "null" ], "enum": [ "main_event_preview", "main_card_preview", "prelim_preview", "event_preview", "results", "card_change", "rankings", "external", null ] }, "generated_at": { "type": [ "string", "null" ], "format": "date-time" }, "sources": { "type": [ "object", "null" ], "properties": { "families": { "type": "array", "items": { "type": "string" } }, "news_item_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } } } }, "bettor_angle": { "oneOf": [ { "$ref": "#/components/schemas/BettorAngle" }, { "type": "null" } ] }, "market_watch": { "oneOf": [ { "$ref": "#/components/schemas/MarketWatch" }, { "type": "null" } ] }, "matchup": { "oneOf": [ { "$ref": "#/components/schemas/MatchupFacts" }, { "type": "null" } ] } } }, "AnalysisSummary": { "type": "object", "description": "Compact bettor-angle summary on list rows and search hits; null for legacy (< v2) fact blocks.", "required": [ "impact_score", "markets", "odds_status", "model_status", "story_class" ], "properties": { "impact_score": { "type": [ "integer", "null" ], "minimum": 1, "maximum": 5, "description": "Analysis, not a price." }, "markets": { "type": "array", "items": { "type": "string" } }, "odds_status": { "type": "string", "enum": [ "unavailable", "snapshot", "live" ] }, "model_status": { "type": "string", "enum": [ "unavailable", "priced" ] }, "story_class": { "type": [ "string", "null" ] } } }, "RankedFighter": { "type": "object", "description": "Linked fighter identity; slug_id = espn_athlete_id || ufcstats_id, the id used by /fighters/- on the web.", "required": [ "id", "name", "slug_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "slug_id": { "type": [ "string", "null" ] } } }, "RankingEntry": { "type": "object", "required": [ "rank", "name", "ufc_slug", "fighter_id", "change", "is_new", "fighter" ], "properties": { "rank": { "type": "integer", "minimum": 1 }, "name": { "type": "string", "description": "Verbatim ufc.com name." }, "ufc_slug": { "type": [ "string", "null" ] }, "fighter_id": { "type": [ "string", "null" ], "format": "uuid" }, "change": { "type": [ "integer", "null" ], "description": "Signed movement; positive = moved up; null = unknown." }, "is_new": { "type": "boolean" }, "fighter": { "oneOf": [ { "$ref": "#/components/schemas/RankedFighter" }, { "type": "null" } ] } } }, "RankingDivision": { "type": "object", "required": [ "key", "label", "is_womens", "is_p4p", "champion", "entries" ], "properties": { "key": { "type": "string", "enum": [ "P4P", "STRAWWEIGHT", "FLYWEIGHT", "BANTAMWEIGHT", "FEATHERWEIGHT", "LIGHTWEIGHT", "WELTERWEIGHT", "MIDDLEWEIGHT", "LIGHT_HEAVYWEIGHT", "HEAVYWEIGHT" ] }, "label": { "type": "string" }, "is_womens": { "type": "boolean" }, "is_p4p": { "type": "boolean" }, "champion": { "oneOf": [ { "type": "object", "required": [ "name", "ufc_slug", "fighter_id", "fighter" ], "properties": { "name": { "type": "string" }, "ufc_slug": { "type": [ "string", "null" ] }, "fighter_id": { "type": [ "string", "null" ], "format": "uuid" }, "fighter": { "oneOf": [ { "$ref": "#/components/schemas/RankedFighter" }, { "type": "null" } ] } } }, { "type": "null" } ] }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/RankingEntry" } } } }, "Rankings": { "type": "object", "required": [ "source", "source_url", "snapshot_date", "captured_at", "divisions" ], "properties": { "source": { "type": "string", "const": "ufc.com official rankings" }, "source_url": { "type": "string", "format": "uri" }, "snapshot_date": { "type": "string", "format": "date" }, "captured_at": { "type": "string", "format": "date-time" }, "divisions": { "type": "array", "items": { "$ref": "#/components/schemas/RankingDivision" } } } }, "FighterRanking": { "type": "object", "description": "Per-fighter verified ranking state (fighter detail include=ranking). Null when no snapshot exists; positions empty when unranked.", "required": [ "source", "source_url", "snapshot_date", "captured_at", "positions" ], "properties": { "source": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "snapshot_date": { "type": "string", "format": "date" }, "captured_at": { "type": "string", "format": "date-time" }, "positions": { "type": "array", "items": { "type": "object", "required": [ "division", "label", "is_womens", "is_p4p", "rank", "is_champion", "change", "is_new" ], "properties": { "division": { "type": "string" }, "label": { "type": "string" }, "is_womens": { "type": "boolean" }, "is_p4p": { "type": "boolean" }, "rank": { "type": "integer", "minimum": 0, "description": "0 = champion." }, "is_champion": { "type": "boolean" }, "change": { "type": [ "integer", "null" ] }, "is_new": { "type": "boolean" } } } } } }, "RoundStatTotals": { "type": "object", "description": "Sum of the round rows for one fighter; a metric is null only when every round is null.", "properties": { "rounds": { "type": "integer" }, "kd": { "type": [ "integer", "null" ] }, "sig_str_landed": { "type": [ "integer", "null" ] }, "sig_str_att": { "type": [ "integer", "null" ] }, "total_str_landed": { "type": [ "integer", "null" ] }, "total_str_att": { "type": [ "integer", "null" ] }, "td_landed": { "type": [ "integer", "null" ] }, "td_att": { "type": [ "integer", "null" ] }, "sub_att": { "type": [ "integer", "null" ] }, "rev": { "type": [ "integer", "null" ] }, "ctrl_sec": { "type": [ "integer", "null" ] }, "head_landed": { "type": [ "integer", "null" ] }, "head_att": { "type": [ "integer", "null" ] }, "body_landed": { "type": [ "integer", "null" ] }, "body_att": { "type": [ "integer", "null" ] }, "leg_landed": { "type": [ "integer", "null" ] }, "leg_att": { "type": [ "integer", "null" ] }, "distance_landed": { "type": [ "integer", "null" ] }, "distance_att": { "type": [ "integer", "null" ] }, "clinch_landed": { "type": [ "integer", "null" ] }, "clinch_att": { "type": [ "integer", "null" ] }, "ground_landed": { "type": [ "integer", "null" ] }, "ground_att": { "type": [ "integer", "null" ] } } }, "ComputedFighterStats": { "type": "object", "description": "Aggregates computed from UFC Stats round rows for this fighter only, with provenance. Not as-of model features.", "required": [ "provenance", "career_totals", "career_rates", "bouts" ], "properties": { "provenance": { "type": "object", "properties": { "source": { "type": "string", "const": "ufcstats_round_stats" }, "method": { "type": "string" }, "bouts_with_stats": { "type": "integer" }, "rounds": { "type": "integer" }, "fight_time_sec": { "type": [ "integer", "null" ] }, "fight_time_basis": { "type": "object", "properties": { "result": { "type": "integer" }, "rounds_x_5min": { "type": "integer" } } }, "coverage_note": { "type": "string" } } }, "career_totals": { "$ref": "#/components/schemas/RoundStatTotals" }, "career_rates": { "type": "object", "description": "Null when the denominator is unknown.", "properties": { "sig_str_landed_per_min": { "type": [ "number", "null" ] }, "sig_str_accuracy": { "type": [ "number", "null" ] }, "total_str_accuracy": { "type": [ "number", "null" ] }, "td_per_15min": { "type": [ "number", "null" ] }, "td_accuracy": { "type": [ "number", "null" ] }, "sub_att_per_15min": { "type": [ "number", "null" ] }, "kd_per_15min": { "type": [ "number", "null" ] }, "ctrl_share": { "type": [ "number", "null" ] }, "head_share": { "type": [ "number", "null" ] }, "body_share": { "type": [ "number", "null" ] }, "leg_share": { "type": [ "number", "null" ] }, "distance_share": { "type": [ "number", "null" ] }, "clinch_share": { "type": [ "number", "null" ] }, "ground_share": { "type": [ "number", "null" ] } } }, "bouts": { "type": "array", "description": "Newest first. One entry per bout with round rows.", "items": { "type": "object", "properties": { "bout_id": { "type": "string", "format": "uuid" }, "event": { "type": [ "object", "null" ] }, "opponent": { "type": [ "object", "null" ], "description": "Compact fighter with primary_image." }, "result": { "type": [ "object", "null" ] }, "outcome": { "type": [ "string", "null" ], "enum": [ "W", "L", "D", "NC", null ] }, "rounds": { "type": "integer" }, "fight_time_sec": { "type": [ "integer", "null" ] }, "fight_time_basis": { "type": "string", "enum": [ "result", "rounds_x_5min", "unknown" ] }, "totals": { "$ref": "#/components/schemas/RoundStatTotals" }, "rounds_detail": { "type": "array", "items": { "type": "object" } } } } } } }, "WireItem": { "type": "object", "required": [ "id", "title", "published_at", "summary", "taxonomy", "taxonomy_detail", "source", "source_url", "fighter_ids", "event_id", "bout_id", "internal_url" ], "properties": { "id": { "type": "string", "format": "uuid" }, "title": { "type": "string", "description": "Verbatim source headline." }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "summary": { "type": [ "string", "null" ], "description": "Verbatim source summary; never generated." }, "taxonomy": { "type": [ "string", "null" ], "description": "First taxonomy label (e.g. card_change, result, injury) or null." }, "taxonomy_detail": { "type": [ "object", "null" ], "description": "Full stored taxonomy: {labels[], scores{}, matched[], confidence}." }, "source": { "type": "object", "required": [ "name", "url" ], "properties": { "name": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ], "format": "uri", "description": "Feed URL of the attributed source." } } }, "source_url": { "type": [ "string", "null" ], "format": "uri", "description": "The item's own URL at the source." }, "fighter_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "event_id": { "type": [ "string", "null" ], "format": "uuid" }, "bout_id": { "type": [ "string", "null" ], "format": "uuid" }, "internal_url": { "type": [ "string", "null" ], "description": "Site-relative canonical destination (/news/…, /fights/…, /events/…, /fighters/…) or null." } } }, "WireMeta": { "type": "object", "required": [ "generated_at", "newest_published_at", "count", "freshness_minutes", "live", "fight_week" ], "properties": { "generated_at": { "type": "string", "format": "date-time", "description": "When the API built this response." }, "newest_published_at": { "type": [ "string", "null" ], "format": "date-time" }, "count": { "type": "integer" }, "limit": { "type": "integer" }, "fetched": { "type": "integer", "description": "Rows read before dedupe." }, "deduped": { "type": "integer", "description": "Rows collapsed as near-duplicate headlines." }, "freshness_minutes": { "type": [ "integer", "null" ], "description": "Age of the newest item in minutes; null when there are no items." }, "live": { "type": "boolean", "description": "True only when freshness_minutes <= 120. Do not label the rail LIVE otherwise." }, "live_threshold_minutes": { "type": "integer", "const": 120 }, "fight_week": { "type": "boolean", "description": "True when a non-Contender-Series UFC event is within the next 6 days or the last 1 day." }, "fight_week_events": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "event_date": { "type": [ "string", "null" ] } } } }, "linked": { "type": "integer", "description": "Items with a non-null internal_url." } } }, "Confidence": { "type": "string", "enum": [ "insufficient", "low", "medium", "high" ], "description": "insufficient = below the registry minimum (min_bouts/min_rounds/min_seconds); low = minimum met but sample_bouts < 3 (result metrics) or sample_seconds < 1800 (rate metrics); medium = < 8 bouts / < 5400 s; high above." }, "DnaOrigin": { "type": "string", "enum": [ "pbe_derived", "source", "licensed", "model" ], "description": "UI labels: PBE DERIVED, SOURCE, LICENSED, MODEL. Snapshot tables are always pbe_derived." }, "MetricObject": { "type": "object", "description": "Every derived number. Sample context is never stripped; value is null when there is no denominator.", "required": [ "metric_key", "value", "unit", "sample_bouts", "sample_rounds", "sample_seconds", "confidence", "coverage_status", "definition_version", "origin" ], "properties": { "metric_key": { "type": "string" }, "value": { "type": [ "number", "object", "null" ], "description": "number, or a record/distribution object for those units" }, "unit": { "type": "string", "enum": [ "ratio", "per_min", "per_15", "seconds", "seconds_per_td", "record", "count", "distribution" ] }, "numerator": { "type": [ "number", "null" ] }, "denominator": { "type": [ "number", "null" ] }, "sample_bouts": { "type": "integer" }, "sample_rounds": { "type": "integer" }, "sample_seconds": { "type": "integer" }, "confidence": { "$ref": "#/components/schemas/Confidence" }, "coverage_status": { "$ref": "#/components/schemas/Confidence" }, "definition_version": { "type": "integer" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" }, "source_families": { "type": "array", "items": { "type": "string" } }, "as_of_date": { "type": "string", "format": "date" } } }, "MetricDefinition": { "type": "object", "description": "Registry row from ufc_dna_metric_definitions plus origin.", "required": [ "metric_key", "definition_version", "family", "display_name", "description", "formula", "min_bouts", "min_rounds", "min_seconds", "public", "active" ], "properties": { "metric_key": { "type": "string" }, "definition_version": { "type": "integer" }, "family": { "type": "string", "enum": [ "stance", "striking", "pace", "grappling", "finish", "context", "position", "composite", "opponent_adjusted" ] }, "display_name": { "type": "string" }, "description": { "type": "string" }, "unit": { "type": [ "string", "null" ] }, "formula": { "type": "string" }, "source_families": { "type": "array", "items": { "type": "string" } }, "min_bouts": { "type": "integer" }, "min_rounds": { "type": "integer" }, "min_seconds": { "type": "integer" }, "public": { "type": "boolean" }, "active": { "type": "boolean" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" } } }, "Record": { "type": "object", "required": [ "w", "l", "d", "nc", "appearances" ], "properties": { "w": { "type": "integer" }, "l": { "type": "integer" }, "d": { "type": "integer" }, "nc": { "type": "integer" }, "appearances": { "type": "integer" } } }, "StanceSplit": { "type": "object", "description": "Snapshot stance_splits entry (keyed by opponent listed stance, plus `open` / `same`).", "required": [ "record", "ko_tko_wins", "submission_wins", "decision_wins", "confidence" ], "properties": { "record": { "$ref": "#/components/schemas/Record" }, "ko_tko_wins": { "type": "integer" }, "submission_wins": { "type": "integer" }, "decision_wins": { "type": "integer" }, "finish_rate": { "$ref": "#/components/schemas/MetricObject" }, "ko_rate": { "$ref": "#/components/schemas/MetricObject" }, "sub_rate": { "$ref": "#/components/schemas/MetricObject" }, "sig_diff_per_min": { "$ref": "#/components/schemas/MetricObject" }, "kd_per_15": { "$ref": "#/components/schemas/MetricObject" }, "td_landed_per_15": { "$ref": "#/components/schemas/MetricObject" }, "stat_bouts": { "type": "integer" }, "stat_rounds": { "type": "integer" }, "observed_seconds": { "type": "integer" }, "confidence": { "$ref": "#/components/schemas/Confidence" } } }, "StanceSplitRow": { "type": "object", "description": "Row from ufc_fighter_stance_splits plus record and origin (served by /fighters/{id}/splits).", "required": [ "fighter_id", "as_of_date", "opponent_stance", "definition_version", "appearances", "wins", "losses", "draws", "no_contests", "ko_tko_wins", "submission_wins", "decision_wins", "stat_bouts", "stat_rounds", "observed_seconds", "metrics", "confidence", "record", "origin" ], "properties": { "fighter_id": { "type": "string", "format": "uuid" }, "as_of_date": { "type": "string", "format": "date" }, "opponent_stance": { "type": "string", "enum": [ "ORTHODOX", "SOUTHPAW", "SWITCH", "OPEN_STANCE", "SIDEWAYS", "UNKNOWN" ] }, "definition_version": { "type": "integer" }, "appearances": { "type": "integer" }, "wins": { "type": "integer" }, "losses": { "type": "integer" }, "draws": { "type": "integer" }, "no_contests": { "type": "integer" }, "ko_tko_wins": { "type": "integer" }, "submission_wins": { "type": "integer" }, "decision_wins": { "type": "integer" }, "stat_bouts": { "type": "integer" }, "stat_rounds": { "type": "integer" }, "observed_seconds": { "type": "integer" }, "metrics": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricObject" }, "description": "finish_rate, ko_rate, sub_rate, sig_diff_per_min, kd_per_15, td_landed_per_15" }, "confidence": { "$ref": "#/components/schemas/Confidence" }, "provenance": { "type": "object" }, "generated_at": { "type": [ "string", "null" ], "format": "date-time" }, "record": { "$ref": "#/components/schemas/Record" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" } } }, "DnaFighter": { "type": "object", "description": "Compact fighter used by DNA routes (compact identity + primary_image + stance + is_active).", "required": [ "id", "name", "slug_id", "primary_image", "stance", "is_active" ], "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "nickname": { "type": [ "string", "null" ] }, "ufcstats_id": { "type": [ "string", "null" ] }, "espn_athlete_id": { "type": [ "string", "null" ] }, "slug_id": { "type": [ "string", "null" ] }, "record_w": { "type": [ "integer", "null" ] }, "record_l": { "type": [ "integer", "null" ] }, "record_d": { "type": [ "integer", "null" ] }, "record_nc": { "type": [ "integer", "null" ] }, "primary_image": { "oneOf": [ { "$ref": "#/components/schemas/PrimaryImage" }, { "type": "null" } ] }, "stance": { "type": [ "string", "null" ] }, "is_active": { "type": [ "boolean", "null" ] } } }, "DnaSnapshot": { "type": "object", "description": "One ufc_fighter_dna_snapshots row as served. as_of_date is exclusive.", "required": [ "as_of_date", "definition_version", "sample_bouts", "sample_completed_bouts", "sample_stat_bouts", "sample_rounds", "sample_seconds", "coverage_status", "metrics", "stance_splits", "round_profile", "finish_profile", "context_splits", "position_profile", "provenance", "origin" ], "properties": { "as_of_date": { "type": "string", "format": "date" }, "definition_version": { "type": "integer" }, "sample_bouts": { "type": "integer" }, "sample_completed_bouts": { "type": "integer" }, "sample_stat_bouts": { "type": "integer" }, "sample_rounds": { "type": "integer" }, "sample_seconds": { "type": "integer" }, "coverage_status": { "$ref": "#/components/schemas/Confidence" }, "metrics": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/MetricObject" } }, "stance_splits": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/StanceSplit" } }, "round_profile": { "type": "object", "description": "rounds{1..5}, pace_retention_r2_vs_r1, pace_retention_r3_vs_r1, championship_round_delta, defensive_drift_r3_vs_r1 (MetricObjects); {} when no stat coverage" }, "finish_profile": { "type": "object", "description": "finish_rate, ko_finish_rate, submission_finish_rate, finish_round_distribution, finish_time_median_sec (MetricObjects), finished_by {ko_tko, submission}" }, "context_splits": { "type": "object" }, "position_profile": { "type": "object", "description": "{} until licensed data exists; never synthesized" }, "archetype": { "type": [ "object", "null" ] }, "provenance": { "type": "object" }, "generated_at": { "type": [ "string", "null" ], "format": "date-time" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" } } }, "DnaFamilyResponse": { "type": "object", "description": "/round-profile, /finish-profile, /position-profile payload.", "required": [ "fighter", "as_of_date", "definition_version", "origin", "sample", "available", "status" ], "properties": { "fighter": { "$ref": "#/components/schemas/DnaFighter" }, "as_of_date": { "type": "string", "format": "date" }, "definition_version": { "type": "integer" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" }, "sample": { "type": "object", "properties": { "sample_bouts": { "type": "integer" }, "sample_completed_bouts": { "type": "integer" }, "sample_stat_bouts": { "type": "integer" }, "sample_rounds": { "type": "integer" }, "sample_seconds": { "type": "integer" }, "sample_minutes": { "type": "number" }, "coverage_status": { "$ref": "#/components/schemas/Confidence" } } }, "available": { "type": "boolean" }, "status": { "type": "string", "enum": [ "ok", "insufficient_coverage", "licensed_data_not_available" ] }, "round_profile": { "type": [ "object", "null" ] }, "finish_profile": { "type": [ "object", "null" ] }, "position_profile": { "type": [ "object", "null" ] }, "note": { "type": "string" } } }, "DnaComparison": { "type": "object", "required": [ "key", "label", "unit", "family", "higher_is_better", "a", "b", "delta", "direction", "comparable", "min_confidence" ], "properties": { "key": { "type": "string" }, "label": { "type": "string" }, "unit": { "type": "string" }, "family": { "type": "string" }, "higher_is_better": { "type": [ "boolean", "null" ], "description": "null for contextual shares/rates" }, "mismatch": { "type": [ "string", "null" ], "description": "insight family this comparison can feed" }, "min_abs_delta": { "type": [ "number", "null" ] }, "a": { "oneOf": [ { "$ref": "#/components/schemas/MetricObject" }, { "type": "null" } ] }, "b": { "oneOf": [ { "$ref": "#/components/schemas/MetricObject" }, { "type": "null" } ] }, "delta": { "type": [ "number", "null" ], "description": "a - b, 4 dp; null unless both sides are numeric" }, "direction": { "type": [ "string", "null" ], "enum": [ "a", "b", "even", null ], "description": "side with the higher value" }, "comparable": { "type": "boolean" }, "min_confidence": { "$ref": "#/components/schemas/Confidence" } } }, "Insight": { "type": "object", "description": "Emitted only when the documented thresholds are met; never from insufficient metrics.", "required": [ "key", "label", "value", "unit", "sample_bouts", "confidence", "direction", "side", "explanation", "origin" ], "properties": { "key": { "type": "string", "example": "a_vs_southpaw_finish_rate" }, "label": { "type": "string" }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string" }, "record": { "$ref": "#/components/schemas/Record" }, "a_value": { "type": "number" }, "b_value": { "type": "number" }, "sample_bouts": { "type": [ "integer", "null" ] }, "sample_rounds": { "type": [ "integer", "null" ] }, "sample_seconds": { "type": [ "integer", "null" ] }, "samples": { "type": "object", "description": "per-side samples on two-sided insights" }, "confidence": { "$ref": "#/components/schemas/Confidence" }, "direction": { "type": "string", "enum": [ "contextual", "a", "b" ] }, "side": { "type": [ "string", "null" ], "enum": [ "a", "b", null ] }, "metric_keys": { "type": "array", "items": { "type": "string" } }, "explanation": { "type": "string", "description": "Deterministic template naming the sample and as-of date." }, "origin": { "$ref": "#/components/schemas/DnaOrigin" } } }, "BettorsEdgeEvidence": { "type": "object", "description": "One-to-one projection of insights for the Bettor's Edge module. Evidence only, never a pick.", "required": [ "key", "label", "value", "unit", "side", "direction", "sample", "confidence", "origin", "origin_label", "explanation" ], "properties": { "key": { "type": "string" }, "label": { "type": "string" }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string" }, "side": { "type": [ "string", "null" ] }, "direction": { "type": "string" }, "sample": { "type": "string", "example": "5 bouts / 13 rounds / 62.0 min" }, "sample_bouts": { "type": [ "integer", "null" ] }, "sample_rounds": { "type": [ "integer", "null" ] }, "sample_seconds": { "type": [ "integer", "null" ] }, "confidence": { "$ref": "#/components/schemas/Confidence" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" }, "origin_label": { "type": "string", "const": "PBE DERIVED" }, "explanation": { "type": "string" } } }, "MatchupDna": { "type": "object", "required": [ "fighters", "a", "b", "comparisons", "stance_context", "insights", "warnings", "bettors_edge_evidence", "origin", "note" ], "properties": { "fighters": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "$ref": "#/components/schemas/DnaFighter" } }, "a": { "type": [ "object", "null" ], "description": "DnaSnapshot subset (as_of_date, definition_version, sample_*, coverage_status, metrics, stance_splits, round_profile, finish_profile) or null" }, "b": { "type": [ "object", "null" ] }, "comparisons": { "type": "array", "items": { "$ref": "#/components/schemas/DnaComparison" } }, "stance_context": { "type": "object", "properties": { "a_stance": { "type": [ "string", "null" ] }, "b_stance": { "type": [ "string", "null" ] }, "context": { "type": "string", "enum": [ "same", "open", "switch_involved", "unknown" ] }, "a_vs_b_stance": { "type": "object", "description": "A split vs B listed stance: {side, fighter_id, opponent_stance, split, appearances, confidence, meets_threshold}" }, "b_vs_a_stance": { "type": "object" }, "a_context_split": { "oneOf": [ { "$ref": "#/components/schemas/StanceSplit" }, { "type": "null" } ] }, "b_context_split": { "oneOf": [ { "$ref": "#/components/schemas/StanceSplit" }, { "type": "null" } ] } } }, "insights": { "type": "array", "items": { "$ref": "#/components/schemas/Insight" } }, "warnings": { "type": "array", "items": { "type": "string" }, "description": "Every threshold not met, naming the missing sample." }, "bettors_edge_evidence": { "type": "array", "items": { "$ref": "#/components/schemas/BettorsEdgeEvidence" } }, "origin": { "$ref": "#/components/schemas/DnaOrigin" }, "note": { "type": "string" } } }, "DnaQueryRow": { "type": "object", "required": [ "fighter", "as_of_date", "metric_key", "metric", "sample", "origin" ], "properties": { "fighter": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": [ "string", "null" ] }, "nickname": { "type": [ "string", "null" ] }, "slug_id": { "type": [ "string", "null" ] }, "stance": { "type": [ "string", "null" ] }, "is_active": { "type": [ "boolean", "null" ] } } }, "as_of_date": { "type": "string", "format": "date" }, "metric_key": { "type": "string" }, "metric": { "$ref": "#/components/schemas/MetricObject" }, "sample": { "type": "object" }, "opponent_stance": { "type": "string", "description": "stance-split mode only" }, "record": { "$ref": "#/components/schemas/Record" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" } } }, "VideoType": { "type": "string", "enum": [ "embedded_episode", "countdown", "fight_preview", "full_fight", "highlights", "interview", "press_conference", "media_day", "weigh_in", "faceoff", "post_fight", "analysis", "other" ] }, "Video": { "type": "object", "description": "Official video metadata from an allowlisted channel. Published rows only; playback stays on the provider.", "required": [ "id", "provider", "provider_video_id", "url", "embed_url", "thumbnail_url", "title", "published_at", "duration_sec", "embeddable", "video_type", "channel", "links", "resolver_confidence", "attribution" ], "properties": { "id": { "type": "string", "format": "uuid" }, "provider": { "type": "string", "example": "youtube" }, "provider_video_id": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Provider watch URL." }, "embed_url": { "type": [ "string", "null" ], "format": "uri", "description": "https://www.youtube-nocookie.com/embed/; null for non-YouTube providers." }, "thumbnail_url": { "type": [ "string", "null" ], "format": "uri" }, "title": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "duration_sec": { "type": [ "integer", "null" ], "description": "null when unknown" }, "embeddable": { "type": [ "boolean", "null" ], "description": "null when not yet checked" }, "live_broadcast_state": { "type": [ "string", "null" ] }, "video_type": { "$ref": "#/components/schemas/VideoType" }, "video_type_label": { "type": "string" }, "channel": { "type": "object", "required": [ "id", "name", "verified" ], "properties": { "id": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "verified": { "type": "boolean", "description": "channel_verified_source at capture" } } }, "links": { "type": "object", "required": [ "event_id", "bout_id", "article_id", "fighter_ids" ], "properties": { "event_id": { "type": [ "string", "null" ], "format": "uuid" }, "bout_id": { "type": [ "string", "null" ], "format": "uuid" }, "article_id": { "type": [ "string", "null" ], "format": "uuid" }, "fighter_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } } } }, "resolver_confidence": { "type": "string", "enum": [ "none", "low", "medium", "high" ] }, "attribution": { "type": "string", "example": "YouTube · UFC", "description": "Render verbatim as the credit." }, "captured_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" } } }, "LedgerSnapshot": { "type": "object", "description": "One append-only ufc_fight_state_ledger row. Blocks without a source are explicit {status: unavailable, reason} objects.", "required": [ "id", "bout_id", "event_id", "checkpoint", "ledger_version", "captured_at", "bout_state", "fighters", "rankings", "dna", "weigh_in", "wire", "odds", "market", "model", "result", "provenance" ], "properties": { "id": { "type": "string", "format": "uuid" }, "bout_id": { "type": "string", "format": "uuid" }, "event_id": { "type": "string", "format": "uuid" }, "checkpoint": { "type": "string", "enum": [ "t_minus_7d", "t_minus_72h", "t_minus_24h", "post_weigh_in", "t_minus_3h", "close", "post_result", "ad_hoc" ] }, "ledger_version": { "type": "integer" }, "captured_at": { "type": "string", "format": "date-time" }, "scheduled_start": { "type": [ "string", "null" ], "format": "date-time" }, "event_date": { "type": [ "string", "null" ], "format": "date" }, "hours_to_start": { "type": [ "number", "null" ] }, "bout_state": { "type": "object" }, "fighters": { "type": "object", "description": "{a, b, stance_context}" }, "rankings": { "type": "object" }, "dna": { "type": "object", "description": "{a, b}: latest snapshot in force per fighter, or {status: unavailable}" }, "weigh_in": { "type": "object" }, "wire": { "type": "object", "description": "{status, count, items[], articles[]}" }, "odds": { "type": "object" }, "market": { "type": "object" }, "model": { "type": "object" }, "result": { "type": "object", "description": "{status: pending | final, winner_id, method, round, time_sec, ...}" }, "provenance": { "type": "object" } } }, "LedgerDiff": { "type": "object", "description": "Deterministic shallow diff between consecutive snapshots (newer vs older); no interpretation.", "required": [ "newer", "older", "hours_between", "changed", "changes" ], "properties": { "newer": { "type": "object", "properties": { "id": { "type": "string" }, "checkpoint": { "type": "string" }, "captured_at": { "type": "string" } } }, "older": { "type": "object", "properties": { "id": { "type": "string" }, "checkpoint": { "type": "string" }, "captured_at": { "type": "string" } } }, "hours_between": { "type": [ "number", "null" ] }, "changed": { "type": "array", "items": { "type": "string" }, "example": [ "fighters.a.stance", "fighters.stance_context", "wire.count" ] }, "changes": { "type": "array", "items": { "type": "object", "required": [ "path", "from", "to" ], "properties": { "path": { "type": "string" }, "from": {}, "to": {} } } } } }, "CardShock": { "type": "object", "description": "Stable placeholder until the Card Shock engine exists. No score is computed.", "required": [ "status", "reason" ], "properties": { "status": { "type": "string", "const": "not_computed" }, "reason": { "type": "string", "const": "card_shock_engine_not_built" } } }, "IntelligenceBout": { "type": "object", "required": [ "bout", "ledger_status", "latest", "hours_to_start", "checkpoints", "snapshots", "has_dna", "wire_count", "result", "sources", "diff", "card_shock" ], "properties": { "bout": { "type": "object" }, "ledger_status": { "type": "string", "enum": [ "ok", "no_checkpoint" ] }, "latest": { "type": [ "object", "null" ], "description": "{id, checkpoint, captured_at, ledger_version, scheduled_start, hours_to_start_at_capture}" }, "hours_to_start": { "type": [ "number", "null" ], "description": "scheduled_start minus meta.generated_at, in hours" }, "checkpoints": { "type": "array", "items": { "type": "string" } }, "snapshots": { "type": "integer" }, "bout_state": { "type": [ "object", "null" ] }, "fighters": { "type": [ "object", "null" ] }, "has_dna": { "type": "object", "properties": { "a": { "type": [ "boolean", "null" ] }, "b": { "type": [ "boolean", "null" ] } } }, "dna": { "type": [ "object", "null" ] }, "wire_count": { "type": [ "integer", "null" ] }, "result": { "type": [ "object", "null" ] }, "sources": { "type": [ "object", "null" ], "description": "{weigh_in, odds, market, model} status strings" }, "diff": { "oneOf": [ { "$ref": "#/components/schemas/LedgerDiff" }, { "type": "null" } ] }, "card_shock": { "$ref": "#/components/schemas/CardShock" } } }, "SuccessEnvelope": { "type": "object", "required": [ "ok", "data", "meta" ], "properties": { "ok": { "type": "boolean", "const": true }, "data": {}, "meta": { "type": "object", "properties": { "api": { "type": "string", "const": "PropSports UFC" }, "version": { "type": "string" }, "request_id": { "type": "string" } } } } }, "ErrorEnvelope": { "type": "object", "required": [ "ok", "data", "error", "meta" ], "properties": { "ok": { "type": "boolean", "const": false }, "data": { "type": "null" }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "detail": {} } }, "meta": { "type": "object" } } }, "Plan": { "type": "string", "enum": [ "developer", "pro", "ultra", "scale", "enterprise" ], "description": "Commercial plan ladder: Developer $79, Pro $199, Ultra $499, Scale $1,499, Enterprise custom." }, "Provenance": { "type": "object", "description": "Evidence carried by every PBE_DERIVED value (subset of MetricObject).", "properties": { "sample_bouts": { "type": "integer" }, "sample_rounds": { "type": "integer" }, "sample_seconds": { "type": "integer" }, "confidence": { "$ref": "#/components/schemas/Confidence" }, "coverage_status": { "$ref": "#/components/schemas/Confidence" }, "definition_version": { "type": "integer" }, "origin": { "$ref": "#/components/schemas/DnaOrigin" }, "source_families": { "type": "array", "items": { "type": "string" } }, "as_of_date": { "type": "string", "format": "date" } } }, "Coverage": { "$ref": "#/components/schemas/Confidence" }, "FighterDna": { "type": "object", "properties": { "fighter": { "$ref": "#/components/schemas/DnaFighter" }, "snapshot": { "$ref": "#/components/schemas/DnaSnapshot" } } }, "RoundProfile": { "type": "object", "description": "round_profile family: per-round pace/absorption MetricObjects plus pace retention, championship-round delta and defensive drift.", "additionalProperties": true }, "FinishProfile": { "type": "object", "description": "finish_profile family: finish_rate, ko_finish_rate, submission_finish_rate, finish_round_distribution, finish_time_median_sec, finished_by.", "additionalProperties": true } } }, "x-plans": { "developer": { "name": "Developer", "price_usd_month": 79, "tagline": "Core UFC data", "position": "Build with normalized UFC data.", "included_requests": 25000, "rate_limit_per_min": 60, "concurrency_limit": 4, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "hard", "features": [ "core", "editorial", "media_metadata", "video_metadata", "dna_registry" ], "cta": "Start building", "highlights": [ "Events", "Cards", "Fighters", "Results", "Rankings", "Search", "Core fight history" ], "public": true }, "pro": { "name": "Pro", "price_usd_month": 199, "tagline": "Fighter intelligence", "position": "Unlock proprietary fighter intelligence.", "included_requests": 100000, "rate_limit_per_min": 180, "concurrency_limit": 8, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "hard", "features": [ "core", "editorial", "media_metadata", "video_metadata", "dna_registry", "round_stats_deep", "dna_fighter", "dna_as_of" ], "cta": "Unlock Fight DNA", "highlights": [ "Everything in Developer", "Fight DNA", "Stance DNA", "Striking DNA", "Grappling DNA", "Finish DNA", "Round profiles", "Deeper stats" ], "recommended": true, "public": true }, "ultra": { "name": "Ultra", "price_usd_month": 499, "tagline": "Matchup intelligence", "position": "Build matchup and fight intelligence products.", "included_requests": 500000, "rate_limit_per_min": 600, "concurrency_limit": 16, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "hard", "features": [ "core", "editorial", "media_metadata", "video_metadata", "dna_registry", "round_stats_deep", "dna_fighter", "dna_as_of", "dna_matchup", "dna_query", "fight_week" ], "cta": "Build with Matchup DNA", "highlights": [ "Everything in Pro", "Matchup DNA", "Advanced context splits", "Historical as-of intelligence", "Fight Week API where available", "Higher quotas" ], "public": true }, "scale": { "name": "Scale", "price_usd_month": 1499, "tagline": "Production infrastructure", "position": "Production infrastructure for serious platforms.", "included_requests": 2000000, "rate_limit_per_min": 1200, "concurrency_limit": 32, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "soft", "features": [ "core", "editorial", "media_metadata", "video_metadata", "dna_registry", "round_stats_deep", "dna_fighter", "dna_as_of", "dna_matchup", "dna_query", "fight_week", "bulk_media_lookup", "priority_support" ], "cta": "Go to Scale", "highlights": [ "Everything in Ultra", "Very high usage", "Higher concurrency", "Priority support", "Direct integration support", "Commercial production terms", "Bulk/custom options where rights permit" ], "public": true }, "enterprise": { "name": "Enterprise", "price_usd_month": null, "price_label": "Let's talk", "tagline": "Custom", "position": "Dedicated infrastructure, custom endpoints, licensing and partnerships.", "included_requests": null, "rate_limit_per_min": null, "concurrency_limit": null, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "custom", "features": [ "core", "editorial", "media_metadata", "video_metadata", "dna_registry", "round_stats_deep", "dna_fighter", "dna_as_of", "dna_matchup", "dna_query", "fight_week", "bulk_media_lookup", "priority_support", "wire", "custom" ], "cta": "Talk to us", "highlights": [ "Dedicated infrastructure", "Custom endpoints", "Large datasets", "Special delivery", "SLAs", "Custom licensing", "Partnerships" ], "public": true }, "first_party": { "name": "First-party", "price_usd_month": null, "tagline": "PropBetEdge properties", "position": "Internal entitlement for PropBetEdge consumer products and PropTechUSA tooling.", "included_requests": null, "rate_limit_per_min": null, "concurrency_limit": null, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "none", "features": [ "*" ], "public": false }, "internal": { "name": "Internal", "price_usd_month": null, "tagline": "Operations", "position": "Smoke tests, monitoring and internal tooling.", "included_requests": null, "rate_limit_per_min": 600, "concurrency_limit": null, "overage": { "enabled": false, "price_usd_per_1k": null }, "limit_mode": "none", "features": [ "*" ], "public": false } }, "x-entitlements": [ { "key": "index", "path": "/v1/ufc", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "events", "path": "/v1/ufc/events", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "event", "path": "/v1/ufc/events/{id}", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "event_card", "path": "/v1/ufc/events/{id}/card", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "event_articles", "path": "/v1/ufc/events/{id}/articles", "feature": "editorial", "minimum_plan": "developer", "origin": "EDITORIAL" }, { "key": "event_videos", "path": "/v1/ufc/events/{id}/videos", "feature": "video_metadata", "minimum_plan": "developer", "origin": "THIRD_PARTY_LINK" }, { "key": "event_intelligence", "path": "/v1/ufc/events/{id}/intelligence", "feature": "fight_week", "minimum_plan": "ultra", "origin": "PBE_DERIVED" }, { "key": "fighters", "path": "/v1/ufc/fighters", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "fighters_media", "path": "/v1/ufc/fighters/media", "feature": "media_metadata", "minimum_plan": "developer", "origin": "MEDIA" }, { "key": "fighter", "path": "/v1/ufc/fighters/{id}", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "fighter_history", "path": "/v1/ufc/fighters/{id}/history", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "fighter_stats", "path": "/v1/ufc/fighters/{id}/stats", "feature": "round_stats_deep", "minimum_plan": "pro", "origin": "PBE_DERIVED" }, { "key": "fighter_articles", "path": "/v1/ufc/fighters/{id}/articles", "feature": "editorial", "minimum_plan": "developer", "origin": "EDITORIAL" }, { "key": "fighter_videos", "path": "/v1/ufc/fighters/{id}/videos", "feature": "video_metadata", "minimum_plan": "developer", "origin": "THIRD_PARTY_LINK" }, { "key": "fighter_dna", "path": "/v1/ufc/fighters/{id}/dna", "feature": "dna_fighter", "minimum_plan": "pro", "origin": "PBE_DERIVED" }, { "key": "fighter_splits", "path": "/v1/ufc/fighters/{id}/splits", "feature": "dna_fighter", "minimum_plan": "pro", "origin": "PBE_DERIVED" }, { "key": "fighter_round_profile", "path": "/v1/ufc/fighters/{id}/round-profile", "feature": "dna_fighter", "minimum_plan": "pro", "origin": "PBE_DERIVED" }, { "key": "fighter_finish_profile", "path": "/v1/ufc/fighters/{id}/finish-profile", "feature": "dna_fighter", "minimum_plan": "pro", "origin": "PBE_DERIVED" }, { "key": "fighter_position_profile", "path": "/v1/ufc/fighters/{id}/position-profile", "feature": "dna_fighter", "minimum_plan": "pro", "origin": "LICENSED" }, { "key": "bout", "path": "/v1/ufc/bouts/{id}", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "bout_stats", "path": "/v1/ufc/bouts/{id}/stats", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "bout_videos", "path": "/v1/ufc/bouts/{id}/videos", "feature": "video_metadata", "minimum_plan": "developer", "origin": "THIRD_PARTY_LINK" }, { "key": "bout_ledger", "path": "/v1/ufc/bouts/{id}/ledger", "feature": "fight_week", "minimum_plan": "ultra", "origin": "PBE_DERIVED" }, { "key": "matchup_dna", "path": "/v1/ufc/matchups/{fighterA}/{fighterB}/dna", "feature": "dna_matchup", "minimum_plan": "ultra", "origin": "PBE_DERIVED" }, { "key": "results", "path": "/v1/ufc/results", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "rankings", "path": "/v1/ufc/rankings", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "news", "path": "/v1/ufc/news", "feature": "editorial", "minimum_plan": "developer", "origin": "EDITORIAL" }, { "key": "article", "path": "/v1/ufc/articles/{slug}", "feature": "editorial", "minimum_plan": "developer", "origin": "EDITORIAL" }, { "key": "wire", "path": "/v1/ufc/wire", "feature": "wire", "minimum_plan": "enterprise", "origin": "THIRD_PARTY_LINK" }, { "key": "search", "path": "/v1/ufc/search", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "counts", "path": "/v1/ufc/counts", "feature": "core", "minimum_plan": "developer", "origin": "SOURCE_FACT" }, { "key": "videos", "path": "/v1/ufc/videos", "feature": "video_metadata", "minimum_plan": "developer", "origin": "THIRD_PARTY_LINK" }, { "key": "dna_metrics", "path": "/v1/ufc/dna/metrics", "feature": "dna_registry", "minimum_plan": "developer", "origin": "PBE_DERIVED" }, { "key": "dna_query", "path": "/v1/ufc/dna/query", "feature": "dna_query", "minimum_plan": "ultra", "origin": "PBE_DERIVED" } ] }