Player Stats

Fetch player statistics by Minecraft Bedrock username.

GET /player/stats/name/{username}

Example:

curl "https://app.zeqa.net/api/player/stats/name/zGqat"

Path Parameters

Parameter	Type	Description
username	string	Minecraft Bedrock username to look up. Usernames with unsupported characters return an error.

Query Parameters

Parameter	Type	Default	Description
rankings	boolean	false	When true, includes the rankings object in the response.

Response Shape

{
  "err": null,
  "result": {
    "lifetime": {
      "kills": 632,
      "deaths": 431,
      "coins": 5132,
      "shards": 480,
      "bp": 23720
    },
    "elo": {
      "boxing": 952,
      "fireballfight": 1038,
      "bedfight": 1079,
      "nodebuff": 919,
      "bridge": 1294,
      "battlerush": 1000,
      "sumo": 953,
      "builduhc": 974,
      "finaluhc": 919,
      "fireballmace": 918,
      "parkour": 1012,
      "crystalpvp": 1000
    },
    "season_stats": {
      "kills": 599,
      "deaths": 414
    },
    "duel_stats": {
      "Boxing": {
        "ranked_wins": 5,
        "ranked_losses": 5,
        "unranked_wins": 21,
        "unranked_losses": 20,
        "current_winstreak": 1,
        "highest_winstreak": 5
      }
    },
    "ffa_stats": {
      "SumoFFA": {
        "kills": 32,
        "deaths": 13,
        "current_killstreak": 0,
        "highest_killstreak": 9
      }
    },
    "rankings": {
      "sumo": 2046810,
      "kills": 73412
    }
  }
}

Result Fields

Field	Type	Description
lifetime	object	Lifetime account totals across Zeqa.
elo	object	Ranked ELO values keyed by duel leaderboard key.
season_stats	object	Current season totals.
duel_stats	object	Per-duel-mode win, loss, and winstreak counters.
ffa_stats	object	Per-FFA-mode kill, death, and killstreak counters.
rankings	object	Included only when rankings=true; numeric leaderboard placements keyed by stat or ELO key. Lower placements are higher ranks.

Lifetime Fields

Field	Type	Description
kills	number	Lifetime kills.
deaths	number	Lifetime deaths.
coins	number	Lifetime coins balance or total as returned by Zeqa.
shards	number	Lifetime shards balance or total as returned by Zeqa.
bp	number	Battle-pass or progression points as returned by Zeqa.

ELO Fields

The elo object uses lowercase leaderboard keys. Observed keys include:

Key	Description
boxing	Boxing ranked ELO.
fireballfight	FireballFight ranked ELO.
bedfight	BedFight ranked ELO.
nodebuff	Nodebuff ranked ELO.
bridge	Bridge ranked ELO.
battlerush	BattleRush ranked ELO.
sumo	Sumo ranked ELO.
builduhc	BuildUHC ranked ELO.
finaluhc	FinalUHC ranked ELO.
fireballmace	FireballMace ranked ELO.
parkour	Parkour ranked ELO.
crystalpvp	CrystalPvP ranked ELO.

Duel Stats Fields

duel_stats is keyed by display-mode name, such as Boxing, Bridge, or FireballFight. Each mode object can contain these fields:

Field	Type	Description
ranked_wins	number	Ranked duel wins in that mode.
ranked_losses	number	Ranked duel losses in that mode.
unranked_wins	number	Unranked duel wins in that mode.
unranked_losses	number	Unranked duel losses in that mode.
current_winstreak	number	Current winstreak in that mode.
highest_winstreak	number	Highest recorded winstreak in that mode.

FFA Stats Fields

ffa_stats is keyed by FFA mode name, such as SumoFFA, SkywarsOres, or MidFight. Each mode object can contain these fields:

Field	Type	Description
kills	number	FFA kills in that mode.
deaths	number	FFA deaths in that mode.
current_killstreak	number	Current killstreak in that mode.
highest_killstreak	number	Highest recorded killstreak in that mode.

JavaScript Example

async function getPlayerStats(username) {
  const params = new URLSearchParams({rankings: 'true'});
  const response = await fetch(
    `https://app.zeqa.net/api/player/stats/name/${encodeURIComponent(username)}?${params}`,
  );
  const data = await response.json();

  if (data.err) {
    throw new Error(data.err);
  }

  return data.result;
}

Error Responses

{
  "err": "Player not found"
}

{
  "err": "Invalid character in a name"
}