Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hypixel SkyBlock API

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

Hypixel SkyBlock API is one of 5 APIs that Hypixel publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include SkyBlock. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and code examples.

This API exposes 16 operations across 16 paths, and defines 6 schemas. It is described by OpenAPI 3.0.3, at version v2.

Requests are made against a single base URL, https://api.hypixel.net.

16 operations 16 paths 6 schemas 16 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v2
Base URL
https://api.hypixel.net/v2
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Hypixel SkyBlock API declares 1 security scheme for authenticating requests. An API key is passed in the header as API-Key (ApiKey). By default, every request must be authenticated.

  • ApiKey — Obtained via the [Hypixel Developer Dashboard](https://developer.hypixel.net) when creating an application. You can also request higher limits for production a…

Paths & Operations 16

Across 16 paths, the API surfaces 16 operations — 16 GET. Each is listed below with its method, path, parameters, and response codes.

SkyBlock 16

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

GET
/v2/resources/skyblock/collections
Hypixel Collections
getResourcesSkyblockCollections → 200
GET
/v2/resources/skyblock/skills
Hypixel Skills
getResourcesSkyblockSkills → 200
GET
/v2/resources/skyblock/items
Hypixel Items
getResourcesSkyblockItems → 200
GET
/v2/resources/skyblock/election
Hypixel Election and Mayor
getResourcesSkyblockElection → 200
GET
/v2/resources/skyblock/bingo
Hypixel Current Bingo Event
getResourcesSkyblockBingo → 200
GET
/v2/skyblock/news
Hypixel News
getSkyblockNews → 200403429
GET
/v2/skyblock/auction
Hypixel Request Auction(s) by the Auction UUID, Player UUID, or Profile UUID.
getSkyblockAuction 3 params → 200400403422429
GET
/v2/skyblock/auctions
Hypixel Active Auctions
getSkyblockAuctions 1 param → 200404422503
GET
/v2/skyblock/auctions_ended
Hypixel Recently Ended Auctions
getSkyblockAuctionsEnded → 200
GET
/v2/skyblock/bazaar
Hypixel Bazaar
getSkyblockBazaar → 200503
GET
/v2/skyblock/profile
Hypixel Profile by UUID
getSkyblockProfile 1 param → 200400403422429
GET
/v2/skyblock/profiles
Hypixel Profiles by Player
getSkyblockProfiles 1 param → 200400403422429
GET
/v2/skyblock/museum
Hypixel Museum Data by Profile ID
getSkyblockMuseum 1 param → 200403422429
GET
/v2/skyblock/garden
Hypixel Garden Data by Profile ID
getSkyblockGarden 1 param → 200403404422429
GET
/v2/skyblock/bingo
Hypixel Bingo Data by Player
getSkyblockBingo 1 param → 200400403404422429
GET
/v2/skyblock/firesales
Hypixel Active/Upcoming Fire Sales
getSkyblockFiresales → 200

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are SkyBlockAuction (18 properties), SkyBlockGarden (10 properties), SkyBlockProfile (7 properties), SkyBlockItem (6 properties). Each schema is shown below with its type and property counts.

SkyBlockFireSale
object
5 properties
SkyBlockItem
object
6 properties
SkyBlockMuseum
object
4 properties
SkyBlockProfile
object
7 properties
SkyBlockGarden
object
Information about a player's SkyBlock garden, the only guaranteed field is the uuid field.
10 properties 1 required
SkyBlockAuction
object
18 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hypixel-skyblock-api-openapi.yml Raw ↑

Other APIs Hypixel publishes across the network.

Hypixel Housing API
Hypixel Other API
Hypixel Player Data API
Hypixel Resources API