Leaderboards

GET /leaderboards

Global paginated ranking for one stat, one gamemode, one mode.

Query parameters

Parameter	Type	Required	Description
type	string	required	gamemode id, see Gamemode Catalog
stat	string	required	raw stat key, case-sensitive, mixed-case (kills, BOW_KILLS)
mode	string	recommended	not crawled without this param; unconfirmed if omittable
interval	string	optional	total | weekly | monthly | yearly, default total
offset	number	optional	zero-indexed, default 0
limit	number	optional	requested page size, hard-capped at 15 server-side

interval=yearly valid only for gamemodes tagged yearly in the Gamemode Catalog. Other gamemodes: 200 with empty result, not 400.

Try it

GET/leaderboards

typebedwarsdungeonsgenpvpkitpvponeblockopfactionsoplifestealopprisonopskyblockpillarsskyminesskypvpsurvivalunrankedpracticestatBED_DESTROYEDBOW_KILLSFINAL_KILLSHIGHEST_WIN_STREAKkillsplayedwinsmodeALL_MODESDOUBLESQUADSOLOTRIPLESintervaltotalweeklymonthlyyearlyoffsetlimit

https://stats.pika-network.net/api/leaderboards?type=bedwars&stat=BED_DESTROYED&interval=total&mode=ALL_MODES&offset=0&limit=15

open

Response 200

LIVE REQUESTopen raw

fetching https://stats.pika-network.net/api/leaderboards?type=bedwars&stat=kills&interval=total&mode=ALL_MODES&offset=0&limit=5 ...

Field	Type	Notes
metadata.total	number	total players tracked for this stat, not page size
entries	Entry[] | null	null observed in place of [] in some cases
entries[].place	number	1-indexed, absolute rank
entries[].value	string	numeric string, see numeric encoding
entries[].id	string	player username
entries[].clan	string	optional omitted, not null, when absent
entries[].rank	string	optional omitted when absent

Request forms

HTTP

GET /leaderboards?type=bedwars&stat=kills&interval=total&mode=ALL_MODES&offset=0&limit=15

cURL

curl 'https://stats.pika-network.net/api/leaderboards?type=bedwars&stat=kills&interval=total&mode=ALL_MODES&offset=0&limit=15'

craftify

import { Gamemode, PikaNetworkClient, Stat } from '@kyizl/craftify';

const pika = new PikaNetworkClient();

await pika.getLeaderboard({
  gamemode: Gamemode.BedWars,
  stat: Stat.BedWars.Kills,
  limit: 15,
});

Errors

Status	Condition
400	invalid type
400	invalid stat for type
400	invalid mode for type
400	stat valid for type overall but not for the requested mode

No 404 case. Unmatched query values return 400; the route itself always resolves.