API ReferenceLeagues
League Readiness
Get comprehensive readiness assessment across 6 dimensions
League Readiness
Retrieve a comprehensive readiness report for a league, evaluating 6 key dimensions on a 0-1000 scale.
Endpoint
GET /v1/leagues/{league_id}/readinessAuthentication
Required. Use Bearer token or X-API-Key header.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
league_id | string | Yes | Unique league identifier (e.g., "ufc", "wsl", "jai-alai") |
Example Request
import { AltSportsData } from 'altsportsdata';
const client = new AltSportsData({ apiKey: 'YOUR_API_KEY' });
const readiness = await client.leagues.readiness('ufc');
console.log(readiness.data);from altsportsdata import AltSportsData
client = AltSportsData(api_key='YOUR_API_KEY')
readiness = client.leagues.readiness('ufc')
print(readiness.data)curl -X GET "https://api.altsportsdata.com/v1/leagues/ufc/readiness" \
-H "Authorization: Bearer YOUR_API_KEY"const response = await fetch("https://api.altsportsdata.com/v1/leagues/ufc/readiness", {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
const readiness = await response.json();
console.log(readiness.data);require 'net/http'
require 'json'
uri = URI('https://api.altsportsdata.com/v1/leagues/ufc/readiness')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = http.request(request)
data = JSON.parse(response.body)<?php
$url = 'https://api.altsportsdata.com/v1/leagues/ufc/readiness';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer YOUR_API_KEY'
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);
?>using System;
using System.Net.Http;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var url = "https://api.altsportsdata.com/v1/leagues/ufc/readiness";
var response = await client.GetStringAsync(url);
Console.WriteLine(response);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.altsportsdata.com/v1/leagues/ufc/readiness"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;
public class LeagueReadiness {
public static void main(String[] args) throws Exception {
String urlString = "https://api.altsportsdata.com/v1/leagues/ufc/readiness";
URL url = new URL(urlString);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
BufferedReader in = new BufferedReader(
new InputStreamReader(conn.getInputStream())
);
String line;
StringBuilder response = new StringBuilder();
while ((line = in.readLine()) != null) {
response.append(line);
}
in.close();
System.out.println(response.toString());
}
}Example Response
{
"data": {
"league_id": "ufc",
"league_name": "Ultimate Fighting Championship",
"overall_readiness_score": 912,
"readiness_grade": "A",
"dimensions": {
"data_infrastructure": {
"score": 945,
"grade": "A",
"details": {
"api_availability": "excellent",
"real_time_feeds": true,
"historical_depth": "10+ years",
"update_frequency": "milliseconds"
}
},
"schedule_reliability": {
"score": 867,
"grade": "B+",
"details": {
"advance_notice": "3-6 months",
"cancellation_rate": "2%",
"rescheduling_frequency": "low"
}
},
"data_quality": {
"score": 932,
"grade": "A",
"details": {
"accuracy_rate": "99.8%",
"completeness": "98%",
"validation_level": "official_feed"
}
},
"market_coverage": {
"score": 889,
"grade": "B+",
"details": {
"markets_available": 18,
"liquidity": "high",
"variance": "moderate"
}
},
"integration_ease": {
"score": 925,
"grade": "A",
"details": {
"api_documentation": "comprehensive",
"sdk_available": true,
"webhook_support": true,
"sample_code": true
}
},
"commercial_viability": {
"score": 918,
"grade": "A",
"details": {
"betting_volume": "very_high",
"audience_size": "global",
"monetization_potential": "premium"
}
}
},
"summary": "UFC demonstrates excellent readiness across all dimensions with particularly strong data infrastructure and commercial viability.",
"recommendations": [
"Continue maintaining high data quality standards",
"Expand market offerings for preliminary card events"
],
"last_evaluated": "2026-03-06T12:00:00Z"
},
"meta": {
"total": 1,
"page": 1,
"limit": 1,
"has_more": false,
"api_version": "v1",
"timestamp": "2026-03-07T06:38:00Z"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
league_id | string | Unique league identifier |
league_name | string | Full league name |
overall_readiness_score | integer | Aggregate readiness score (0-1000) |
readiness_grade | string | Letter grade (A+, A, B+, B, C+, C, D, F) |
dimensions | object | Six readiness dimensions with scores and details |
dimensions.*.score | integer | Dimension score (0-1000) |
dimensions.*.grade | string | Dimension letter grade |
dimensions.*.details | object | Detailed metrics for the dimension |
summary | string | Executive summary of readiness |
recommendations | array | Actionable recommendations |
last_evaluated | string | ISO 8601 timestamp of last evaluation |
Readiness Dimensions
The six dimensions evaluated are:
- Data Infrastructure — API availability, real-time feeds, historical depth
- Schedule Reliability — Advance notice, cancellation rates, consistency
- Data Quality — Accuracy, completeness, validation level
- Market Coverage — Available betting markets, liquidity, variance
- Integration Ease — Documentation, SDKs, webhooks, sample code
- Commercial Viability — Betting volume, audience size, monetization potential