API Reference

This section documents the broader ALT Sports Data platform API.

Use this section when you want the long-form platform docs for league intelligence, discovery, valuation, utility routes, and the wider product surface.

If you want the pure route-by-route interactive tester, use API Reference instead.

Base URL

https://api.altsportsdata.com/api/v1/public

Authentication

Use the ALT Sports Data credential in the X-API-KEY header for platform routes in this section:

X-API-KEY: YOUR_API_KEY

The same credential can also be used in the SDKs, MCP server, and the pure interactive reference.

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.