canonical: https://jentic.com/apis/hypixel.net/hypixel

# Hypixel Public API

The Hypixel Public API exposes data from the Hypixel Minecraft server network, covering player stats, guilds, online status, and the SkyBlock game mode. Authenticated endpoints return player, guild, SkyBlock profile, housing, leaderboard, and booster data, while a set of public endpoints serve game resources and the SkyBlock auction house and bazaar without a key. Authenticated requests pass an API key in the API-Key header.

## For AI agents

Read Hypixel network data: player stats, guilds, online status, SkyBlock profiles and economy, leaderboards, and game resources. Some endpoints need an API key; others are public.

## Scope

Does not modify game state, manage accounts, or cover non-Hypixel Minecraft servers. Use for reading Hypixel player, guild, SkyBlock, and game-resource data only.

## Capabilities

- Retrieve a player's stats, recent games, and online status
- Look up a guild's data
- Read SkyBlock profiles, museums, gardens, and news
- Query the SkyBlock auction house and bazaar
- Fetch game resources such as achievements, quests, and skills
- Read leaderboards, boosters, and player counts

## Use cases

### Agent-Powered Player Stat Lookups

An AI agent answering questions about a Hypixel player or building a stats overlay retrieves their profile on demand. The Hypixel Public API returns a player's stats, recent games, and online status, so the agent grounds its answers in live data through Jentic. These endpoints require an API key.

Example prompt: Look up a player's stats and recent games by their UUID

### SkyBlock Economy Tracking

A trading tool or bot tracks SkyBlock item prices across the bazaar and auction house. The Hypixel Public API's bazaar and auction endpoints are public and return live market data, so an agent can watch prices and flag deals without a key.

Example prompt: Fetch current SkyBlock bazaar prices and flag items below a target price

### Game Resource Reference

An app needs the canonical list of Hypixel achievements, quests, or SkyBlock skills to label player data. The Hypixel Public API serves these game resources on public endpoints, so an agent can pull the reference data it needs to interpret a player's progress.

Example prompt: Fetch the SkyBlock skills resource and map a player's XP to skill levels

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v2/player` | Get a player's stats |
| GET | `/v2/status` | Get a player's online status |
| GET | `/v2/guild` | Look up a guild |
| GET | `/v2/skyblock/bazaar` | Get SkyBlock bazaar prices |
| GET | `/v2/skyblock/auctions` | List SkyBlock auctions |
| GET | `/v2/resources/skyblock/skills` | Get the SkyBlock skills resource |
| GET | `/v2/leaderboards` | Read leaderboards |
| GET | `/v2/counts` | Get player counts |

## Key resources

- **Players** — Retrieve player stats, recent games, and online status
- **Guilds** — Look up guild data by name or member
- **SkyBlock** — Read SkyBlock profiles, economy, and news, including auctions and bazaar
- **Game Resources** — Fetch public reference data such as achievements, quests, and skills

## Why Jentic

- **Setup:** Wiring Hypixel by hand means sending your API key in the API-Key header on the authenticated endpoints, leaving it off the public ones, and mapping 34 player, guild, and SkyBlock endpoints yourself. Through Jentic you install once, import the Hypixel Public API from the Directory, store your key once, and your agent calls it.
- **Permission scoping:** Every Hypixel operation is a read, and the key is carried in a header rather than a resource path, so rules govern which operations your agent may call. You choose those operations, so you can allow the public bazaar and resource endpoints while withholding the player and guild lookups that need a key.
- **Credential handling:** Your Hypixel API key is stored once, encrypted, by your own Jentic One instance and injected at execution time on the endpoints that require it. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get a hypixel player' or 'read the skyblock bazaar', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint.

## Related APIs

- **Mojang API** — The Mojang API resolves Minecraft usernames to UUIDs and profiles, complementing Hypixel lookups that key off a player's UUID.
- **Bungie.net API** — The Bungie.net API serves Destiny player and game data, an alternative game-stats source for a different title than Hypixel.
- **Riot Games API** — The Riot Games API provides player and match data for League of Legends and other Riot titles, another game-stats source distinct from Hypixel.

## FAQ

### Does the Hypixel Public API require an API key?

Some endpoints do and some don't. Player, guild, SkyBlock profile, housing, and leaderboard endpoints require an API key sent in the API-Key header, while the game resource, SkyBlock auction, and bazaar endpoints are public, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected on the calls that need it.

### Is there a Hypixel API MCP server?

You don't need an MCP server to give your agent the Hypixel Public API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent reads player, guild, and SkyBlock data as it needs to. Nothing extra is loaded into the agent's context until a call is made.

### Can I limit what my agent is allowed to do with the Hypixel Public API?

Yes. Every operation is read-only, and you choose which of the 34 your agent may call, so you can allow public resource and market endpoints while withholding the authenticated player and guild lookups. Every call it makes is logged for review.

### Can I track SkyBlock auction and bazaar prices with the Hypixel Public API?

Yes. The SkyBlock bazaar and auctions endpoints are public and return live market data, so an agent can poll them to track prices without an API key.

### How do I look up a Hypixel player through Jentic?

Search Jentic for 'get a hypixel player', which returns the player operation with its input schema. Add the Hypixel Public API from the Jentic API Directory, store your API key once for the authenticated endpoints, and your agent can read player and SkyBlock data. To run it on your own infrastructure, install Jentic One from its GitHub repo.