Skip to main content

Python wrapper around riot games developer api.

Project description

pyltover

Python wrapper around riot games developer api.

Supported APIs

  • Account
    • v1
      • Get Account by puuid
      • Get Account by riot id
      • Get active shard for a player
      • Get active region (lol and tft)
      • Get account by access token - Not possible with development key
  • Champion Mastery
    • v4
      • Get all champion mastery entries sorted by number of champion points descending.
      • Get a champion mastery by puuid and champion ID.
      • Get specified number of top champion mastery entries sorted by number of champion points descending.
      • Get a player's total champion mastery score, which is the sum of individual champion mastery levels.
  • Champion
    • v3
      • Returns champion rotations, including free-to-play and low-level free-to-play rotations (REST)
  • Clash
    • v1
      • Get players by puuid
      • Get team by ID.
      • Get all active or upcoming tournaments.
      • Get tournament by team ID.
      • Get tournament by ID.
  • League entries
    • v4
      • Get all the league entries.
  • League
    • v4
      • Get the challenger league for given queue.
      • Get league entries in all queues for a given puuid
      • Get all the league entries.
      • Get the grandmaster league of a specific queue.
      • Get league with given ID, including inactive entries.
      • Get the master league for given queue.
  • Challenges
    • v1
      • List of all basic challenge configuration information (includes all translations for names and descriptions)
      • Map of level to percentile of players who have achieved it - keys: ChallengeId -> Season -> Level -> percentile of players who achieved it
      • Get challenge configuration (REST)
      • Return top players for each level. Level must be MASTER, GRANDMASTER or CHALLENGER.
      • Map of level to percentile of players who have achieved it
      • Returns player information with list of all progressed challenges (REST)

How to use?

Get your token from Riot games developer website.

import asyncio
from pyltover import Pyltover


async def main():
    pyltover = Pyltover("your token")
    champion_mastery_score = await pyltover.euw.v4.get_total_champion_mastery_score("puuid")
    print(champion_mastery_score)

    account_details = await pyltover.europe.v1.get_account_by_puuid("puuid")
    print(account_details)

    champion_rotation = await pyltover.euw.v3.get_champion_rotaions("puuid")
    print(champion_rotation)

asyncio.run(main())

Servers are listed as properties under pyltover root object, e.g. pytlover.euw or pyltover.na. The API versions are listed under each server, e.g. pyltover.euw.v1 or pyltover.euw.v4.

The response objects are Pydantic model objects.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyltover-0.1.0.tar.gz (9.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyltover-0.1.0-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

File details

Details for the file pyltover-0.1.0.tar.gz.

File metadata

  • Download URL: pyltover-0.1.0.tar.gz
  • Upload date:
  • Size: 9.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.9

File hashes

Hashes for pyltover-0.1.0.tar.gz
Algorithm Hash digest
SHA256 305be64ae793ea41490c270b7b9ea020972cc42664b5a40ea6eb0c7e4ad98a72
MD5 83a24bd97d7bfae7f7e03a79edc6b0e6
BLAKE2b-256 a7482d14b21d366134255df22d1198d7e86cdbdaefda7667048b5ff8ef2ab0f2

See more details on using hashes here.

File details

Details for the file pyltover-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: pyltover-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 11.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.9

File hashes

Hashes for pyltover-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7fe42b67a462444135f43ac411012afa63375033ba4a3b2cb4432108e94e7882
MD5 b91e7a7756bf339f1368ff930d08ff7e
BLAKE2b-256 a262411da3332b92d88cd3277f439ce8df71ba473405f6ce0524c1bd5660b6dd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page