Are you a developer?

mrjprotank

We built and publish our own Python library, mrjprotank, for connecting to this portal and fetching everything it shows — online counts, player lookups, clan data, and leaderboards — in real time, from your own scripts. It works anywhere Python runs: Linux, Windows, or macOS.

Install

# works on Linux, Windows, and macOS
pip install mrjprotank

Requires Python 3.8+. The only dependency is requests, which pip installs automatically.

Using it

Create a client once, then call whatever you need.

from mrjprotank import ProTankClient

client = ProTankClient()

Online right now (plus today's / this week's peak)

client.online()
# {'current_online': 154, 'max_today': 734, 'max_week': 861, ...}

Online during a specific 10-minute window in the past

client.online_at("2026-07-31T18:20:00")

A specific member — online/offline, last seen, current battle, clan, garage, and stats, all in one call

client.player("SomeUsername")

A specific clan — search, then full profile

client.search_clan("ABC")
client.clan("ABC")

Clan leaderboard

client.clan_leaderboard()

Player leaderboards — by category, page by page

# one page (100 rows) at a time, starting from an offset
client.leaderboard_page("kd", offset=0)
client.leaderboard_page("kd", offset=100)
# ...rows come back empty once you're past the end

# or let it page through the whole thing for you
for row in client.leaderboard("kd"):
    print(row["position"], row["username"], row["value_human"])

All leaderboard categories

Pass any of these as the first argument to leaderboard_page() / leaderboard():

Using the parameterised categories (mode, supplies)
⚠️Premium in leaderboards is false, you can use per user search to see the real premium

# time played in TDM
client.leaderboard_page("mode", mode="TDM", mode_metric="time")

# XP earned in CTF
client.leaderboard_page("mode", mode="CTF", mode_metric="score")

# medkits used
client.leaderboard_page("supplies", supply="heal")

# all supplies combined (omit supply=)
client.leaderboard_page("supplies")

These same categories are what you can pick from on the Leaderboards page — the API just gives you the raw rows instead of the rendered table.