Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

A python library to use the Challonge API

Project description


async Challonge for Python 3.5+

Build Status Documentation Status Coverage Status

Modern library that is more than just a wrapper for the Challonge web API


  • aiohttp


  • cchardet faster replacement for chardet, as mentionned on the aiohttp page
  • aiodns for speeding up DNS resolving, highly recommended by aiohttp

Python version support

  • 3.5
  • 3.6
  • 3.7


pip install achallonge

If you want to have the optional dependencies for aiohttp, you can:

pip install achallonge[speed]


import challonge

async def foo():
    # Log in into Challonge with your CHALLONGE! API credentials (
    user = await challonge.get_user('your_challonge_username', 'your_api_key')

    # Retrieve your tournaments
    tournaments = await user.get_tournaments()

    # Tournaments, matches, and participants are all represented as Python classes
    for t in tournaments:
        print(  # 3272
        print(  # 'My Awesome Tournament'
        print(t.status)  # 'open'

    # Retrieve the participants for a given tournament.
    participants = await tournaments[0].get_participants()
    print(len(participants)) # 13


The full documentation can be found on Read the docs

Author / License

Distributed under MIT license. See LICENSE for details

Fabien Poupineau (fp12) - 2017-2019

Twitter: @fp12gaming

Join the Discord Server and discuss about this lib!

Project details

Download files

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

Files for achallonge, version 1.8.1
Filename, size File type Python version Upload date Hashes
Filename, size achallonge-1.8.1-py3-none-any.whl (19.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size achallonge-1.8.1.tar.gz (15.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page