Authorization: Bearer YOUR_API_KEY

curl -X GET "https://api.sportsstack.com/api/v1/sports" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sportsstack.com/api/v1/sports', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const { data: sports } = await response.json();

import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
response = requests.get('https://api.sportsstack.com/api/v1/sports', headers=headers)
sports = response.json()['data']

{
  "data": [
    {
      "common_model_id": "4af4c296-6fbc-4705-8660-3b587c252e16",
      "name": "basketball",
      "abbreviation": "bball"
    },
    {
      "common_model_id": "58e8c89b-72f8-4427-adbc-10f193c9b462",
      "name": "football",
      "abbreviation": "nfl"
    }
  ]
}

curl -X GET "https://api.sportsstack.com/api/v1/leagues?sport_id=SPORT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/teams?league_id=LEAGUE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/players?league_id=LEAGUE_ID&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/events?league_id=LEAGUE_ID&season_year=2024&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/event-stats?event_id=EVENT_ID&for_entity_type=player" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  `https://api.sportsstack.com/api/v1/event-stats?event_id=${eventId}&for_entity_type=player`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const { data: stats } = await response.json();

curl -X GET "https://api.sportsstack.com/api/v1/seasons/2024/season-stats?league_id=LEAGUE_ID&for_entity_type=player&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/events/EVENT_ID/plays?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/events/EVENT_ID/play-stats?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.sportsstack.com/api/v1/odds?event_id=EVENT_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  `https://api.sportsstack.com/api/v1/odds?event_id=${eventId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const { data: odds } = await response.json();

response = requests.get(
    f'https://api.sportsstack.com/api/v1/odds?event_id={event_id}',
    headers=headers
)
odds = response.json()['data']

curl -X GET "https://api.sportsstack.com/api/v1/events/EVENT_ID/odds" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "main_lines": {
      "away_team": {"team_id": "uuid", "name": "SF 49ers", "abbreviation": "SF"},
      "home_team": {"team_id": "uuid", "name": "PHI Eagles", "abbreviation": "PHI"},
      "markets": {
        "spread": {
          "away": {"line": "+2.5", "odds": [{"price": -102, "sportsbook": "draftkings"}]},
          "home": {"line": "-2.5", "odds": [{"price": -120, "sportsbook": "draftkings"}]}
        },
        "moneyline": {
          "away": {"odds": [{"price": 124, "sportsbook": "draftkings"}]},
          "home": {"odds": [{"price": -146, "sportsbook": "draftkings"}]}
        },
        "total": {
          "over": {"line": "45.5", "odds": [{"price": -115, "sportsbook": "draftkings"}]},
          "under": {"line": "45.5", "odds": [{"price": -105, "sportsbook": "draftkings"}]}
        }
      }
    },
    "other_markets": [...]
  }
}

curl -X GET "https://api.sportsstack.com/api/v1/futures?league_id=LEAGUE_ID&include_outcomes=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

// 1. Get live events
const liveEvents = await fetch(
  'https://api.sportsstack.com/api/v1/events?status=in_progress&league_id=LEAGUE_ID',
  { headers }
).then(r => r.json());

// 2. Poll for updates
setInterval(async () => {
  for (const event of liveEvents.data) {
    const updated = await fetch(
      `https://api.sportsstack.com/api/v1/events/${event.common_model_id}?include_scoreboard=true`,
      { headers }
    ).then(r => r.json());

    updateUI(updated.data);
  }
}, 30000); // Every 30 seconds

// 1. Get player info
const player = await fetch(
  `https://api.sportsstack.com/api/v1/players/${playerId}`,
  { headers }
).then(r => r.json());

// 2. Get season stats
const seasonStats = await fetch(
  `https://api.sportsstack.com/api/v1/seasons/2024/season-stats?for_entity_type=player&for_entity_id=${playerId}&league_id=${leagueId}`,
  { headers }
).then(r => r.json());

// 3. Get recent game performances
const recentEvents = await fetch(
  `https://api.sportsstack.com/api/v1/events?league_id=${leagueId}&status=completed&limit=10`,
  { headers }
).then(r => r.json());

// 4. Get stats for each event
const gameStats = await Promise.all(
  recentEvents.data.map(event =>
    fetch(
      `https://api.sportsstack.com/api/v1/event-stats?event_id=${event.common_model_id}&for_entity_id=${playerId}`,
      { headers }
    ).then(r => r.json())
  )
);

import requests

# Get upcoming events
events = requests.get(
    'https://api.sportsstack.com/api/v1/events',
    params={'league_id': LEAGUE_ID, 'status': 'scheduled', 'limit': 5},
    headers=headers
).json()['data']

# Get odds for each event
for event in events:
    odds = requests.get(
        'https://api.sportsstack.com/api/v1/odds',
        params={'event_id': event['common_model_id'], 'is_main': 'true'},
        headers=headers
    ).json()['data']

    # Group by outcome and find best odds
    from collections import defaultdict
    by_outcome = defaultdict(list)
    for odd in odds:
        by_outcome[odd['outcome_name']].append(odd)

    for outcome_name, outcome_odds in by_outcome.items():
        best = max(outcome_odds, key=lambda x: float(x['price']))
        print(f"{outcome_name}: Best at {best['sportsbook']} ({best['price']})")

// 1. Get all players in league
const players = await fetch(
  `https://api.sportsstack.com/api/v1/players?league_id=${leagueId}&limit=500`,
  { headers }
).then(r => r.json());

// 2. Get season stats for all players
const seasonStats = await fetch(
  `https://api.sportsstack.com/api/v1/seasons/2024/season-stats?league_id=${leagueId}&for_entity_type=player`,
  { headers }
).then(r => r.json());

// 3. Join players with stats
const playersWithStats = players.data.map(player => {
  const stats = seasonStats.data.find(s => s.for_entity_id === player.common_model_id);
  return { ...player, stats: stats?.data || {} };
});

// 4. Sort by fantasy-relevant metrics
const topPlayers = playersWithStats
  .filter(p => p.stats.points_per_game)
  .sort((a, b) => b.stats.points_per_game - a.stats.points_per_game)
  .slice(0, 20);

curl -X GET "https://api.sportsstack.com/api/v1/mappings?entity_type=player&common_model_id=PLAYER_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "entity_type": "player",
      "common_model_id": "4af4c296-6fbc-4705-8660-3b587c252e16",
      "source": "sportradar.basketball.nba",
      "source_id": "sr:player:12345"
    },
    {
      "entity_type": "player",
      "common_model_id": "4af4c296-6fbc-4705-8660-3b587c252e16",
      "source": "ftn.basketball.nba",
      "source_id": "ftn-67890"
    }
  ]
}

try {
  const response = await fetch(url, { headers });

  if (!response.ok) {
    if (response.status === 401) {
      // Handle authentication error
      throw new Error('Invalid API key');
    }
    if (response.status === 429) {
      // Handle rate limiting
      const retryAfter = response.headers.get('Retry-After');
      await sleep(retryAfter * 1000);
      return retry();
    }
    throw new Error(`API error: ${response.status}`);
  }

  return response.json();
} catch (error) {
  console.error('Request failed:', error);
  throw error;
}