Skip to content
BlockFrontBlockFront DocsOfficial Documentation for BlockFront

Live stats

These routes need no key, and scoreboard, map_stats and map_ratings can be called from a browser.

The number of players online.

GET /api/v2/?type=player_count
{ "playersOnline": 97 }

The monthly scoreboards for players and brigades.

GET /api/v2/?type=scoreboard&board=players&limit=10
Parameter Description
board players or clans. Leave it out for both.
offset The number of entries to skip.
limit The number of entries to return.
uuid Returns the standing of one player or, with board=clans, one brigade.
{
"generatedAt": 1793380001526,
"resetTime": 1793491199999,
"offset": 0,
"limit": 1,
"players": [
{
"rank": 1,
"uuid": "00000000-0000-0000-0000-000000000000",
"name": "Example",
"score": 8477
}
]
}

Times are in milliseconds since the Unix epoch. resetTime is when the scoreboard next resets. A player who has opted out appears as { "rank": 1, "hidden": true, "score": 8477 }.

Win rates and combat stats for each map, mode and team, refreshed every few minutes.

GET /api/v2/?type=map_stats&map=Storm

Leave out map to get every map.

{
"generatedAt": 1793379700835,
"maps": [
{
"map": "Storm",
"modes": [
{
"map": "Storm",
"mode": "dom",
"matches": 360,
"teams": {
"Allies": {
"matches": 355,
"wins": 126,
"winRate": 0.355,
"kills": 18787,
"deaths": 20796,
"kd": 0.903,
"score": 53202
},
"Axis": {
"matches": 360,
"wins": 237,
"winRate": 0.658,
"kills": 21967,
"deaths": 19471,
"kd": 1.128,
"score": 71636
}
}
}
]
}
]
}

Player star ratings for each map, mode and team. It takes the same map parameter.

GET /api/v2/?type=map_ratings&map=Storm
{
"generatedAt": 1793379700835,
"maps": [
{
"map": "Storm",
"modes": [
{
"map": "Storm",
"mode": "dom",
"ratings": 120,
"average": 4.2,
"stars": { "1": 2, "2": 3, "3": 15, "4": 40, "5": 60 },
"teams": {
"Allies": { "ratings": 60, "average": 4.1, "stars": { "5": 28 } }
}
}
]
}
]
}

stars counts the ratings at each number of stars.