Skip to main content

framework created to use the API provided by the online game Hattrick

Project description


pyCHPP is an object-oriented python framework created to use the API provided by the online game Hattrick (


pyCHPP can be installed using pip :

pip install pychpp


First connection

from pychpp import CHPP
# Set consumer_key and consumer_secret provided for your app by Hattrick
consumer_key = ''
consumer_secret = ''
# Initialize CHPP instance
chpp = CHPP(consumer_key, consumer_secret)
# Get url, request_token and request_token_secret to request API access
# You can set callback_url and scope
auth = chpp.get_auth(callback_url="", scope="")
# auth['url'] contains the url to which the user can grant the application
# access to the Hattrick API
# Once the user has entered their credentials,
# a code is returned by Hattrick (directly or to the given callback url)
code = ""

# Get access token from Hattrick
# access_token['key'] and access_token['secret'] have to be stored
# in order to be used later by the app
access_token = chpp.get_access_token(

Further connections

# Once you have obtained access_token for a user
# You can use it to call Hattrick API
chpp = CHPP(consumer_key,
# Now you can use chpp methods to get datas from Hattrick API
# For example :
current_user = chpp.user()
all_teams = current_user.teams

best_team_ever =
best_team_ever # <HTTeam object : Les Poitevins de La Chapelle (1165592)>

best_team_arena = best_team_ever.arena
best_team_arena # <HTArena object : Stade de La Chapelle (1162154)> # 'Stade de La Chapelle'

worth_team_ever =
worth_team_ever # <HTTeam object : Capdenaguet (1750803)>

player = chpp.player(ht_id=6993859)
player # <HTPlayer object : Pedro Zurita (6993859)>
player.career_goals # 1163

match = chpp.match(ht_id=68599186)
match # <HTMatch object : Skou United - FC Barentin (68599186)> # datetime.datetime(2006, 2, 23, 20, 0)

Mapping table between classes and CHPP XML files

The following table shows the relationships between pyCHPP classes and CHPP XML files :

pyCHPP class CHPP XML files
HTArena arenadetails.xml
HTChallengeManager challenges.xml
HTLeague leaguedetails.xml
HTLeagueFixtures leaguefixtures.xml
HTMatch matchdetails.xml
HTMatchLineup matchlineup.xml
HTMatchesArchive matchesarchive.xml
HTNationalTeam nationalteamdetails.xml
HTNationalTeams nationalteams.xml
HTPlayer playerdetails.xml
HTRegion regiondetails.xml
HTTeam teamdetails.xml
HTUser managercompendium.xml
HTWorld worlddetails.xml
HTWorldCupGroups worldcup.xml
HTWorldCupMatches worldcup.xml
HTYouthPlayer youthplayerdetails.xml
HTYouthTeam youthteamdetails.xml


pyCHPP is licensed under the Apache License 2.0.

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

pychpp-0.3.7.tar.gz (38.7 kB view hashes)

Uploaded source

Built Distribution

pychpp-0.3.7-py3-none-any.whl (48.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page