Hypixel website screenshot

Hypixel

Hypixel Public API — the official REST API of the Hypixel Minecraft server network, the largest Minecraft minigame server. The API exposes player profiles and stats, guilds, friends, recent games, online status, server-wide counts, network boosters, punishment statistics, leaderboards, housing, and the full SkyBlock economy (auctions, bazaar, profiles, museum, garden, bingo, fire sales). All endpoints are read-only HTTP GET requests returning JSON, authenticated with a per-application API key issued via the Hypixel Developer Dashboard.

Hypixel publishes 5 APIs on the APIs.io network, including Housing API, Other API, Player Data API, and 2 more. Tagged areas include Games And Comics, Gaming, Minecraft, Player Stats, and Leaderboards.

The Hypixel catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Hypixel’s developer surface includes authentication and 17 more developer resources.

50.3/100 developing ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
5 APIs
Games And ComicsGamingMinecraftPlayer StatsLeaderboardsSkyBlockPublic APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 50.3/100 · developing
Contract Quality 17.3 / 25
Developer Ergonomics 3.9 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 8.2 / 10
Agent readiness — 37/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/hypixel: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Hypixel Housing API

Hypixel Housing — active public houses, per-player public houses, and per-house information.

Hypixel Other API

Network-wide telemetry — boosters, counts, leaderboards, punishment statistics.

Hypixel Player Data API

Hypixel network player profiles, recent games, online status, friends, and guild lookups.

Hypixel Resources API

Static reference data — games, achievements, challenges, quests, guild achievements, vanity pets and companions.

Hypixel SkyBlock API

Hypixel SkyBlock — auctions, bazaar, profiles, museum, garden, bingo, fire sales, and SkyBlock-specific reference data.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Hypixel Public API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Hypixel Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Hypixel Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Hypixel Public Api Context

11 classes · 74 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Hypixel API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Hypixel API Rules

40 rules · 16 errors 18 warnings 6 info

SPECTRAL

JSON Schema 11

Standalone JSON Schema definitions for this provider's data models.

ActiveBooster

0 properties

JSON SCHEMA

Booster

7 properties

JSON SCHEMA

Game

6 properties

JSON SCHEMA

HousingHouse

6 properties

JSON SCHEMA

QueuedBooster

0 properties

JSON SCHEMA

SkyBlockAuction

18 properties

JSON SCHEMA

SkyBlockFireSale

5 properties

JSON SCHEMA

SkyBlockGarden

10 properties

JSON SCHEMA

SkyBlockItem

6 properties

JSON SCHEMA

SkyBlockMuseum

4 properties

JSON SCHEMA

SkyBlockProfile

7 properties

JSON SCHEMA

Scroll for all 11

JSON Structure 11

JSON Structure definitions describing this provider's data shapes.

Hypixel Public Api Booster Structure

7 properties

JSON STRUCTURE

Hypixel Public Api Game Structure

6 properties

JSON STRUCTURE

Hypixel Public Api Housing House Structure

6 properties

JSON STRUCTURE

Scroll for all 11

Examples 9

Example request and response payloads for these APIs.

Scroll for all 9

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Hypixel Authentication

apiKey · 1 scheme

SECURITY

Hypixel Domain Security

TLSv1.3 · DNSSEC · DMARC

SECURITY

Hypixel Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Hypixel Agentic Access

68 operations

68 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: hypixel
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/hypixel.png
name: Hypixel
description: Hypixel Public API — the official REST API of the Hypixel Minecraft server network, the largest Minecraft minigame
  server. The API exposes player profiles and stats, guilds, friends, recent games, online status, server-wide counts, network
  boosters, punishment statistics, leaderboards, housing, and the full SkyBlock economy (auctions, bazaar, profiles, museum,
  garden, bingo, fire sales). All endpoints are read-only HTTP GET requests returning JSON, authenticated with a per-application
  API key issued via the Hypixel Developer Dashboard.
url: https://api.hypixel.net/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-30'
x-source: public-apis/public-apis
x-category: Games & Comics
x-type: company
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
- Games And Comics
- Gaming
- Minecraft
- Player Stats
- Leaderboards
- SkyBlock
- Public APIs
apis:
- aid: hypixel:hypixel-housing-api
  name: Hypixel Housing API
  description: Hypixel Housing — active public houses, per-player public houses, and per-house information.
  humanURL: https://api.hypixel.net/
  baseURL: https://api.hypixel.net/v2
  tags:
  - Housing
  properties:
  - type: OpenAPI
    url: openapi/hypixel-housing-api-openapi.yml
  - type: Documentation
    url: https://api.hypixel.net/
  - type: DeveloperPortal
    url: https://developer.hypixel.net/
  - type: Policies
    url: https://developer.hypixel.net/policies
  - type: SDKs
    url: https://github.com/HypixelDev/PublicAPI
  - type: CodeExamples
    url: https://github.com/HypixelDev/PublicAPI/tree/master/hypixel-api-example
- aid: hypixel:hypixel-other-api
  name: Hypixel Other API
  description: Network-wide telemetry — boosters, counts, leaderboards, punishment statistics.
  humanURL: https://api.hypixel.net/
  baseURL: https://api.hypixel.net/v2
  tags:
  - Other
  properties:
  - type: OpenAPI
    url: openapi/hypixel-other-api-openapi.yml
  - type: Documentation
    url: https://api.hypixel.net/
  - type: DeveloperPortal
    url: https://developer.hypixel.net/
  - type: Policies
    url: https://developer.hypixel.net/policies
  - type: SDKs
    url: https://github.com/HypixelDev/PublicAPI
  - type: CodeExamples
    url: https://github.com/HypixelDev/PublicAPI/tree/master/hypixel-api-example
- aid: hypixel:hypixel-player-data-api
  name: Hypixel Player Data API
  description: Hypixel network player profiles, recent games, online status, friends, and guild lookups.
  humanURL: https://api.hypixel.net/
  baseURL: https://api.hypixel.net/v2
  tags:
  - Player Data
  properties:
  - type: OpenAPI
    url: openapi/hypixel-player-data-api-openapi.yml
  - type: Documentation
    url: https://api.hypixel.net/
  - type: DeveloperPortal
    url: https://developer.hypixel.net/
  - type: Policies
    url: https://developer.hypixel.net/policies
  - type: SDKs
    url: https://github.com/HypixelDev/PublicAPI
  - type: CodeExamples
    url: https://github.com/HypixelDev/PublicAPI/tree/master/hypixel-api-example
- aid: hypixel:hypixel-resources-api
  name: Hypixel Resources API
  description: Static reference data — games, achievements, challenges, quests, guild achievements, vanity pets and companions.
  humanURL: https://api.hypixel.net/
  baseURL: https://api.hypixel.net/v2
  tags:
  - Resources
  properties:
  - type: OpenAPI
    url: openapi/hypixel-resources-api-openapi.yml
  - type: Documentation
    url: https://api.hypixel.net/
  - type: DeveloperPortal
    url: https://developer.hypixel.net/
  - type: Policies
    url: https://developer.hypixel.net/policies
  - type: SDKs
    url: https://github.com/HypixelDev/PublicAPI
  - type: CodeExamples
    url: https://github.com/HypixelDev/PublicAPI/tree/master/hypixel-api-example
- aid: hypixel:hypixel-skyblock-api
  name: Hypixel SkyBlock API
  description: Hypixel SkyBlock — auctions, bazaar, profiles, museum, garden, bingo, fire sales, and SkyBlock-specific reference
    data.
  humanURL: https://api.hypixel.net/
  baseURL: https://api.hypixel.net/v2
  tags:
  - SkyBlock
  properties:
  - type: OpenAPI
    url: openapi/hypixel-skyblock-api-openapi.yml
  - type: Documentation
    url: https://api.hypixel.net/
  - type: DeveloperPortal
    url: https://developer.hypixel.net/
  - type: Policies
    url: https://developer.hypixel.net/policies
  - type: SDKs
    url: https://github.com/HypixelDev/PublicAPI
  - type: CodeExamples
    url: https://github.com/HypixelDev/PublicAPI/tree/master/hypixel-api-example
common:
- type: AgenticAccess
  url: agentic-access/hypixel-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/hypixel-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/hypixel-domain-security.yml
- type: Authentication
  url: authentication/hypixel-authentication.yml
- type: Website
  url: https://hypixel.net/
- type: DeveloperPortal
  url: https://developer.hypixel.net/
- type: ApiHelpForum
  url: https://hypixel.net/forums/api-help.111/
- type: TermsOfService
  url: https://hypixel.net/tos
- type: Policies
  url: https://developer.hypixel.net/policies
- type: GitHubOrganization
  url: https://github.com/HypixelDev
- type: SourceCode
  url: https://github.com/HypixelDev/PublicAPI
- type: PublicAPIsListing
  url: https://github.com/public-apis/public-apis
- type: Plans
  url: plans/hypixel-plans-pricing.yml
- type: RateLimits
  url: rate-limits/hypixel-rate-limits.yml
- type: FinOps
  url: finops/hypixel-finops.yml
- type: Spectral
  url: rules/hypixel-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/hypixel-vocabulary.yml
- type: JSONLD
  url: json-ld/hypixel-public-api-context.jsonld
features:
- name: Player Data
  description: Retrieve a player's full profile and per-game statistics by Minecraft UUID, including their recent games and
    current online status.
- name: Guild Lookup
  description: Resolve a Hypixel guild by guild id, player UUID, or guild name and return its members, ranks, level, and per-game
    experience.
- name: Network Boosters
  description: Read the list of active in-network coin/XP boosters and the queue waiting to activate per game.
- name: Server Counts and Leaderboards
  description: Get real-time player counts per game and lobby plus the official network leaderboards across every supported
    Hypixel game.
- name: Punishment Statistics
  description: Read network-wide moderation statistics including watchdog/staff bans today and historical totals.
- name: SkyBlock Economy
  description: Full access to the SkyBlock economy — active auctions (paged), recently ended auctions, the live bazaar, fire
    sales, plus per-profile data (profile, profiles, museum, garden, bingo).
- name: SkyBlock Resources
  description: Static SkyBlock resource catalogs — collections, skills, items, current election and mayor, and the current
    bingo event.
- name: Game Resources
  description: Static reference data for the network — game types, achievements, challenges, quests, guild achievements, and
    vanity pets / companions.
- name: Housing
  description: Active public houses across the network, the public houses owned by a given player, and the full data of a
    single house.
useCases:
- name: Public Stats Sites
  description: Build a third-party stats website (e.g. plancke.io style) that resolves a Minecraft username to UUID and renders
    the player's full Hypixel profile, recent games, guild, and per-game stats.
- name: SkyBlock Flipping and Arbitrage Tools
  description: Subscribe to active SkyBlock auctions and bazaar order books to power flipping calculators, arbitrage scanners,
    and craft-cost analyzers.
- name: Guild Dashboards and Bots
  description: Power Discord bots and guild dashboards that resolve guild membership, track per-game contribution, and rank
    guild members on the network leaderboards.
- name: Network Status Widgets
  description: Build status widgets and lobby-finder tools using the live /counts and /status endpoints.
- name: Watchdog and Moderation Reporting
  description: Surface daily and historical watchdog/staff ban counts from /punishmentstats for community moderation transparency
    reports.
integrations:
- name: Minecraft / Mojang UUID Resolution
  description: Players are addressed by Minecraft UUID; consumers typically resolve usernames via the Mojang API first, then
    query Hypixel by UUID.
- name: Hypixel ModAPI (Forge / Fabric)
  description: The Hypixel ModAPI lets Minecraft mods request a subset of Hypixel data via the Minecraft plugin-message system
    in-game, complementing this REST API.
solutions:
- name: SkyBlock Tooling Ecosystem
  description: The Hypixel API underpins a large ecosystem of community SkyBlock tools — auction flippers, museum / collection
    trackers, bazaar arbitrage bots, and profile viewers.
- name: Network Telemetry
  description: Counts, leaderboards, boosters, and punishment statistics together form a public telemetry surface for the
    entire Hypixel network.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com