API Reference

The AltSportsData API provides programmatic access to comprehensive sports league data, analytics, and intelligence. All endpoints follow RESTful conventions and return JSON responses.

Base URL

https://api.altsportsdata.com

Authentication

Most endpoints require authentication via Bearer token or X-API-Key header:

Authorization: Bearer YOUR_API_KEY

or

X-API-Key: YOUR_API_KEY

Endpoints

Leagues

Core league data and operations:

• List Leagues — GET /v1/leagues
• Get League — GET /v1/leagues/{league_id}
• League Stats — GET /v1/leagues/stats/summary
• League Fingerprint — GET /v1/leagues/{league_id}/fingerprint
• League Valuation — GET /v1/leagues/{league_id}/valuation
• League Qualification — GET /v1/leagues/{league_id}/qualification
• League Readiness — GET /v1/leagues/{league_id}/readiness
• Compare Leagues — GET /v1/leagues/{league_id}/compare/{other_id}
• Similar Leagues — GET /v1/leagues/{league_id}/similar
• Evaluate League — POST /v1/leagues/{league_id}/evaluate

Discovery

Search and discover leagues:

• Search Leagues — GET /v1/discovery/search
• Find Similar Leagues — GET /v1/discovery/similar/{league_id}

Valuation

League valuation and tier classification:

• Evaluate League — POST /v1/valuation/evaluate
• Get Tier Definitions — GET /v1/valuation/tiers

Sports & Metadata

Sports categories and archetypes:

• List Sports — GET /v1/sports
• List Archetypes — GET /v1/sports/archetypes

Events

Sports events and schedules:

• List Events — GET /v1/events

Markets

Betting and trading markets:

• List Markets — GET /v1/markets

Utility

Health checks and API information:

• Health Check — GET /v1/health
• API Info — GET /v1/info

Response Format

All API responses follow a standard structure:

{
  "data": { /* response data */ },
  "meta": {
    "total": 100,
    "page": 1,
    "limit": 20,
    "has_more": true,
    "api_version": "v1",
    "timestamp": "2026-03-07T00:00:00Z"
  }
}

Error Handling

Errors return appropriate HTTP status codes with detailed messages:

{
  "error": {
    "code": "invalid_request",
    "message": "Missing required parameter: league_id",
    "status": 400
  }
}

Rate Limits

API rate limits vary by subscription tier. Rate limit headers are included in all responses:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1678901234

SDKs

Official SDKs are available for:

• TypeScript/JavaScript: npm install altsportsdata
• Python: pip install altsportsdata

See individual endpoint pages for SDK usage examples.