AltSportsData

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}/readiness

Authentication

Required. Use Bearer token or X-API-Key header.

Path Parameters

ParameterTypeRequiredDescription
league_idstringYesUnique 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

FieldTypeDescription
league_idstringUnique league identifier
league_namestringFull league name
overall_readiness_scoreintegerAggregate readiness score (0-1000)
readiness_gradestringLetter grade (A+, A, B+, B, C+, C, D, F)
dimensionsobjectSix readiness dimensions with scores and details
dimensions.*.scoreintegerDimension score (0-1000)
dimensions.*.gradestringDimension letter grade
dimensions.*.detailsobjectDetailed metrics for the dimension
summarystringExecutive summary of readiness
recommendationsarrayActionable recommendations
last_evaluatedstringISO 8601 timestamp of last evaluation

Readiness Dimensions

The six dimensions evaluated are:

  1. Data Infrastructure — API availability, real-time feeds, historical depth
  2. Schedule Reliability — Advance notice, cancellation rates, consistency
  3. Data Quality — Accuracy, completeness, validation level
  4. Market Coverage — Available betting markets, liquidity, variance
  5. Integration Ease — Documentation, SDKs, webhooks, sample code
  6. Commercial Viability — Betting volume, audience size, monetization potential

On this page