NAV
shell javascript python

League of Legends API

Welcome to the BALLDONTLIE League of Legends (LoL) API, the best esports API on the planet. This API contains comprehensive data for professional League of Legends matches, tournaments, teams, players, champions, items, runes, and spells. An API key is required. You can obtain an API key by creating a free account on our website. Read the authentication section to learn how to use the API key.

Take a look at our other APIs.

Join us on discord.

AI-Powered Integration

Using the OpenAPI Specification with AI

Our complete OpenAPI specification allows AI assistants to automatically understand and interact with our API. Simply share the spec URL with your AI assistant and describe what you want to build—the AI will handle the technical implementation.

Getting Started with AI:

  1. Copy this URL: https://www.balldontlie.io/openapi.yml
  2. Share it with your preferred AI assistant (ChatGPT, Claude, Gemini, etc.)
  3. Tell the AI what you want to build (e.g., "Create a dashboard showing T1 match results")
  4. The AI will read the OpenAPI spec and write the code for you

Example prompts to try:

This makes it incredibly easy for non-technical users, analysts, and researchers to leverage our esports data without needing to learn programming from scratch.

Account Tiers

There are three different account tiers which provide you access to different types of data. Visit our website to create an account for free.

Paid tiers do not apply across sports. The tier you purchase for League of Legends will not automatically be applied to other sports. You can purchase the ALL-ACCESS ($299.99/mo) tier to get access to every endpoint for every sport.

Read the table below to see the breakdown.

Endpoint Free ALL-STAR GOAT
Teams Yes Yes Yes
Players Yes Yes Yes
Items Yes Yes Yes
Rune Paths Yes Yes Yes
Runes Yes Yes Yes
Spells Yes Yes Yes
Champions Yes Yes Yes
Tournaments No Yes Yes
Tournament Teams No Yes Yes
Tournament Roster No Yes Yes
Champion Stats No Yes Yes
Matches No No Yes
Match Maps No No Yes
Player Match Map Stats No No Yes
Team Match Map Stats No No Yes
Player Overall Stats No No Yes

The feature breakdown per tier is shown in the table below.

Tier Requests / Min $USD / mo.
GOAT 600 39.99
ALL-STAR 60 9.99
Free 5 0

Authentication

To authorize, use this code:

curl "api_endpoint_here" -H "Authorization: YOUR_API_KEY"

fetch("api_endpoint_here", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
});

import requests

response = requests.get(
    "api_endpoint_here",
    headers={"Authorization": "YOUR_API_KEY"}
)

Make sure to replace YOUR_API_KEY with your actual API key.

BALLDONTLIE uses API keys to allow access to the API. You can register for a new API key at our developer portal.

BALLDONTLIE expects for the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: YOUR_API_KEY

Pagination

All paginated endpoints support cursor-based pagination. The API returns a meta object containing pagination information:

{
  "data": [...],
  "meta": {
    "next_cursor": 123,
    "per_page": 25
  }
}

To fetch the next page, include the cursor query parameter:

curl "https://api.balldontlie.io/lol/v1/teams?cursor=123&per_page=25" \
  -H "Authorization: YOUR_API_KEY"

Parameters: - cursor (optional): The cursor value from the previous response's meta.next_cursor - per_page (optional): Number of results per page (default: 25, max: 100)

Teams

Get All Teams

curl "https://api.balldontlie.io/lol/v1/teams?per_page=25" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/teams?per_page=25", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/teams",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"per_page": 25}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 14,
      "name": "Fnatic",
      "slug": "fnatic",
      "country": "United Kingdom",
      "region": {
        "id": 3,
        "name": "Europe"
      }
    },
    {
      "id": 6,
      "name": "G2 Esports",
      "slug": "g2-esports",
      "country": "Germany",
      "region": {
        "id": 3,
        "name": "Europe"
      }
    }
  ],
  "meta": {
    "next_cursor": 5862,
    "per_page": 25
  }
}

This endpoint retrieves all League of Legends teams.

HTTP Request

GET https://api.balldontlie.io/lol/v1/teams

Query Parameters

Parameter Default Description
search null Search teams by name
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination

Players

Get All Players

curl "https://api.balldontlie.io/lol/v1/players?per_page=25" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/players?per_page=25", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/players",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"per_page": 25}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 9621,
      "nickname": "Faker",
      "slug": "faker",
      "first_name": "Sang-hyeok",
      "last_name": "Lee",
      "birthday": "1996-05-07",
      "country": "South Korea",
      "country_code": "KR",
      "team": {
        "id": 15,
        "name": "T1"
      }
    }
  ],
  "meta": {
    "next_cursor": 26630,
    "per_page": 25
  }
}

This endpoint retrieves all League of Legends players.

HTTP Request

GET https://api.balldontlie.io/lol/v1/players

Query Parameters

Parameter Default Description
search null Search players by nickname, first name, or last name
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination

Items

Get All Items

curl "https://api.balldontlie.io/lol/v1/items" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/items", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/items",
    headers={"Authorization": "YOUR_API_KEY"}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 408,
      "name": "Abyssal Mask",
      "is_trinket": false
    },
    {
      "id": 524,
      "name": "Aegis of the Legion",
      "is_trinket": false
    },
    {
      "id": 1,
      "name": "Oracle Lens",
      "is_trinket": true
    }
  ]
}

This endpoint retrieves all League of Legends items and trinkets.

HTTP Request

GET https://api.balldontlie.io/lol/v1/items

Rune Paths

Get All Rune Paths

curl "https://api.balldontlie.io/lol/v1/rune_paths" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/rune_paths", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/rune_paths",
    headers={"Authorization": "YOUR_API_KEY"}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 5,
      "name": "Domination"
    },
    {
      "id": 3,
      "name": "Inspiration"
    },
    {
      "id": 4,
      "name": "Precision"
    },
    {
      "id": 1,
      "name": "Resolve"
    },
    {
      "id": 2,
      "name": "Sorcery"
    }
  ]
}

This endpoint retrieves all League of Legends rune paths.

HTTP Request

GET https://api.balldontlie.io/lol/v1/rune_paths

Runes

Get All Runes

curl "https://api.balldontlie.io/lol/v1/runes" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/runes", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/runes",
    headers={"Authorization": "YOUR_API_KEY"}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 2,
      "name": "Ability Haste",
      "rune_path": null,
      "rune_type": "shard"
    },
    {
      "id": 13,
      "name": "Absolute Focus",
      "rune_path": {
        "id": 2,
        "name": "Sorcery"
      },
      "rune_type": "slot2"
    },
    {
      "id": 41,
      "name": "Aftershock",
      "rune_path": {
        "id": 1,
        "name": "Resolve"
      },
      "rune_type": "keystone"
    }
  ]
}

This endpoint retrieves all League of Legends runes.

HTTP Request

GET https://api.balldontlie.io/lol/v1/runes

Spells

Get All Spells

curl "https://api.balldontlie.io/lol/v1/spells" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/spells", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/spells",
    headers={"Authorization": "YOUR_API_KEY"}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 7,
      "name": "Barrier"
    },
    {
      "id": 8,
      "name": "Cleanse"
    },
    {
      "id": 10,
      "name": "Flash"
    },
    {
      "id": 6,
      "name": "Ignite"
    },
    {
      "id": 12,
      "name": "Smite"
    },
    {
      "id": 11,
      "name": "Teleport"
    }
  ]
}

This endpoint retrieves all League of Legends summoner spells.

HTTP Request

GET https://api.balldontlie.io/lol/v1/spells

Champions

Get All Champions

curl "https://api.balldontlie.io/lol/v1/champions" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/champions", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/champions",
    headers={"Authorization": "YOUR_API_KEY"}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 168,
      "name": "Aatrox"
    },
    {
      "id": 167,
      "name": "Ahri"
    },
    {
      "id": 166,
      "name": "Akali"
    },
    {
      "id": 165,
      "name": "Akshan"
    },
    {
      "id": 164,
      "name": "Alistar"
    }
  ]
}

This endpoint retrieves all League of Legends champions.

HTTP Request

GET https://api.balldontlie.io/lol/v1/champions

Tournaments

Get All Tournaments

curl "https://api.balldontlie.io/lol/v1/tournaments?per_page=25" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/tournaments?per_page=25", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/tournaments",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"per_page": 25}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 345,
      "name": "Worlds 2027",
      "slug": "worlds-2027",
      "start_date": "2027-10-01T09:00:00.000Z",
      "end_date": null,
      "prize": null,
      "tier": "s",
      "status": "upcoming"
    },
    {
      "id": 344,
      "name": "Mid-Season Invitational 2027",
      "slug": "mid-season-invitational-2027",
      "start_date": "2027-06-01T20:00:00.000Z",
      "end_date": null,
      "prize": null,
      "tier": "s",
      "status": "upcoming"
    }
  ],
  "meta": {
    "next_cursor": 343,
    "per_page": 25
  }
}

This endpoint retrieves all League of Legends tournaments.

HTTP Request

GET https://api.balldontlie.io/lol/v1/tournaments

Query Parameters

Parameter Default Description
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination

Tournament Teams

Get Tournament Teams

curl "https://api.balldontlie.io/lol/v1/tournament_teams?tournament_id=345" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/tournament_teams?tournament_id=345", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/tournament_teams",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"tournament_id": 345}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "tournament_id": 345,
      "team": {
        "id": 15,
        "name": "T1"
      }
    },
    {
      "tournament_id": 345,
      "team": {
        "id": 14,
        "name": "Fnatic"
      }
    }
  ]
}

This endpoint retrieves all teams participating in a specific tournament.

HTTP Request

GET https://api.balldontlie.io/lol/v1/tournament_teams

Query Parameters

Parameter Required Description
tournament_id Yes The ID of the tournament

Tournament Roster

Get Tournament Roster

curl "https://api.balldontlie.io/lol/v1/tournament_roster?tournament_id=345&team_id=15" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/tournament_roster?tournament_id=345&team_id=15", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/tournament_roster",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"tournament_id": 345, "team_id": 15}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "tournament_id": 345,
      "team_id": 15,
      "player": {
        "id": 9621,
        "nickname": "Faker"
      }
    }
  ]
}

This endpoint retrieves the roster for a specific team in a tournament.

HTTP Request

GET https://api.balldontlie.io/lol/v1/tournament_roster

Query Parameters

Parameter Required Description
tournament_id Yes The ID of the tournament
team_id Yes The ID of the team

Champion Stats

Get Champion Stats

curl "https://api.balldontlie.io/lol/v1/champion_stats" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/champion_stats", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/champion_stats",
    headers={"Authorization": "YOUR_API_KEY"}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 63,
      "champion": {
        "id": 63,
        "name": "Rell"
      },
      "games_count": 5971,
      "picks_count": 5971,
      "picks_rate": 0.0346,
      "wins_count": 3054,
      "loses_count": 2917,
      "win_rate": 0.5115,
      "ban_rate": 0.0154,
      "avg_kills": 0.862,
      "avg_deaths": 3.994,
      "avg_assists": 11.333,
      "kda": 3.053,
      "kp": 0.7742,
      "avg_damage_dealt_to_champions": 5515.705,
      "avg_gold_earned": 8219.561,
      "avg_gold_per_min": 257.52,
      "avg_creep_score": 47.436
    }
  ]
}

This endpoint retrieves champion statistics across all professional games.

HTTP Request

GET https://api.balldontlie.io/lol/v1/champion_stats

Matches

Get All Matches

curl "https://api.balldontlie.io/lol/v1/matches?per_page=25" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/matches?per_page=25", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/matches",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"per_page": 25}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 1,
      "slug": "fnatic-lol-vs-g2-esports-lol-08-02-2026",
      "tournament": {
        "id": 307,
        "name": "LEC 2026 Versus",
        "slug": "lec-2026-versus",
        "start_date": "2026-01-16T16:00:00.000Z",
        "end_date": null,
        "prize": null,
        "tier": "s",
        "status": "upcoming"
      },
      "team1": {
        "id": 14,
        "name": "Fnatic"
      },
      "team2": {
        "id": 6,
        "name": "G2 Esports"
      },
      "winner": null,
      "team1_score": 0,
      "team2_score": 0,
      "bo_type": 1,
      "status": "upcoming",
      "start_date": "2026-02-08T19:45:00.000Z",
      "end_date": null
    }
  ],
  "meta": {
    "next_cursor": 2,
    "per_page": 25
  }
}

This endpoint retrieves all League of Legends professional matches.

HTTP Request

GET https://api.balldontlie.io/lol/v1/matches

Query Parameters

Parameter Default Description
team_ids null Filter by team IDs (array)
tournament_ids null Filter by tournament IDs (array)
dates null Filter by specific dates (YYYY-MM-DD format, array)
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination

Match Maps

Get Match Maps (Games)

curl "https://api.balldontlie.io/lol/v1/match_maps?match_id=1" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/match_maps?match_id=1", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/match_maps",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"match_id": 1}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 123,
      "match_id": 1,
      "game_number": 1,
      "winner": {
        "id": 14,
        "name": "Fnatic"
      },
      "loser": {
        "id": 6,
        "name": "G2 Esports"
      },
      "duration": 1800,
      "status": "finished",
      "begin_at": "2026-02-08T19:45:00.000Z",
      "end_at": "2026-02-08T20:15:00.000Z"
    }
  ]
}

This endpoint retrieves all games (maps) for a specific match.

HTTP Request

GET https://api.balldontlie.io/lol/v1/match_maps

Query Parameters

Parameter Required Description
match_id Yes The ID of the match

Player Match Map Stats

Get Player Match Map Stats

curl "https://api.balldontlie.io/lol/v1/player_match_map_stats?match_map_id=123" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/player_match_map_stats?match_map_id=123", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/player_match_map_stats",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"match_map_id": 123}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 456,
      "match_map_id": 123,
      "player": {
        "id": 9621,
        "nickname": "Faker"
      },
      "team": {
        "id": 15,
        "name": "T1"
      },
      "champion": {
        "id": 167,
        "name": "Ahri"
      },
      "role": "mid",
      "level": 18,
      "kills": 8,
      "deaths": 2,
      "assists": 12,
      "kill_participation": 0.87,
      "creep_score": 287,
      "gold_earned": 15234,
      "gold_per_min": 507.8,
      "total_damage_dealt_to_champions": 28956,
      "wards_placed": 15,
      "kills_wards": 8,
      "items": [
        {
          "id": 249,
          "name": "Infinity Edge",
          "is_trinket": false
        }
      ],
      "spells": [
        {
          "id": 10,
          "name": "Flash"
        }
      ],
      "runes": [
        {
          "rune_path": {
            "id": 5,
            "name": "Domination"
          },
          "keystone": {
            "id": 69,
            "name": "Electrocute",
            "rune_path": {
              "id": 5,
              "name": "Domination"
            },
            "rune_type": "keystone"
          },
          "path_type": "primary"
        }
      ]
    }
  ],
  "meta": {
    "next_cursor": 457,
    "per_page": 25
  }
}

This endpoint retrieves player statistics for a specific game (map).

HTTP Request

GET https://api.balldontlie.io/lol/v1/player_match_map_stats

Query Parameters

Parameter Default Description
match_map_id null Filter by match map (game) ID
player_id null Filter by player ID
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination

Team Match Map Stats

Get Team Match Map Stats

curl "https://api.balldontlie.io/lol/v1/team_match_map_stats?match_map_id=123" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/team_match_map_stats?match_map_id=123", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/team_match_map_stats",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"match_map_id": 123}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 789,
      "match_map_id": 123,
      "team": {
        "id": 15,
        "name": "T1"
      },
      "enemy_team": {
        "id": 14,
        "name": "Fnatic"
      },
      "side": "blue",
      "color": "blue",
      "kills": 23,
      "deaths": 15,
      "assists": 48,
      "creep_score": 1287,
      "gold_earned": 68456,
      "total_damage_dealt_to_champions": 98765,
      "baron_kills": 2,
      "dragon_kills": 3,
      "herald_kills": 1,
      "first_blood": true,
      "first_tower": true,
      "first_baron": false,
      "first_dragon": true
    }
  ],
  "meta": {
    "next_cursor": 790,
    "per_page": 25
  }
}

This endpoint retrieves team statistics for a specific game (map).

HTTP Request

GET https://api.balldontlie.io/lol/v1/team_match_map_stats

Query Parameters

Parameter Default Description
match_map_id null Filter by match map (game) ID
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination

Player Overall Stats

Get Player Overall Stats

curl "https://api.balldontlie.io/lol/v1/player_overall_stats?per_page=25" \
  -H "Authorization: YOUR_API_KEY"

fetch("https://api.balldontlie.io/lol/v1/player_overall_stats?per_page=25", {
  headers: {
    Authorization: "YOUR_API_KEY",
  },
})
  .then((response) => response.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
    "https://api.balldontlie.io/lol/v1/player_overall_stats",
    headers={"Authorization": "YOUR_API_KEY"},
    params={"per_page": 25}
)

data = response.json()

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 1,
      "player": {
        "id": 121,
        "nickname": "1334mat"
      },
      "maps_played": 1,
      "total_kills": 12,
      "avg_kills": 12,
      "total_deaths": 4,
      "avg_deaths": 4,
      "total_assists": 8,
      "avg_assists": 8,
      "kp": 0.7143,
      "total_damage": 28926,
      "avg_damage": 28926,
      "avg_gold_per_min": 579.67,
      "avg_creep_score": 238
    },
    {
      "id": 2,
      "player": {
        "id": 122,
        "nickname": "Naros"
      },
      "maps_played": 2,
      "total_kills": 23,
      "avg_kills": 11.5,
      "total_deaths": 5,
      "avg_deaths": 2.5,
      "total_assists": 17,
      "avg_assists": 8.5,
      "kp": 0.8163,
      "total_damage": 59370,
      "avg_damage": 29685,
      "avg_gold_per_min": 512.115,
      "avg_creep_score": 262
    }
  ],
  "meta": {
    "next_cursor": 2,
    "per_page": 25
  }
}

This endpoint retrieves overall career statistics for players.

HTTP Request

GET https://api.balldontlie.io/lol/v1/player_overall_stats

Query Parameters

Parameter Default Description
player_ids null Filter by player IDs (array)
per_page 25 Number of results per page (max 100)
cursor null Cursor for pagination
shell javascript python