SkyBlock API

SkyBlock API is a way to access SkyBlock related data outside of the game. It is part of the official Hypixel Public API and allows automated access to e.g. auctions and Bazaar information, or SkyBlock player profiles including stats, skills, collections, and inventories.

Many fan-made sites, mods and tools use this API data to great effect. It is also possible to change some API settings to hide some profile data from the API.

Accessing the API
The official API documentation can be found at https://api.hypixel.net/. An API Key with a default rate limit of 120 requests per minute can be obtained by using the  command in-game. Not all API endpoints require an API key. Several static or semi-static endpoints like Active auctions or Bazaar data don't require an API key.

Convert player name to uuid
Any parameter that represents a player or a SkyBlock profile should be filled with the UUID, not the player name. The only exception is 's name field, but it is deprecated. The official Mojang API can be used to convert a player name to the corresponding player uuid: https://api.mojang.com/users/profiles/minecraft/retchro_

Parse items and inventories data
Items and inventory data are provided as GZip compressed NBT data, which is Base64 encoded. There are various libraries for most programming languages that make working with NBT data easier.

Active auctions
Returns up to 1000 active auctions per page. https://api.hypixel.net/skyblock/auctions?page= Page

Recently ended auctions
Returns all auctions that ended in the last 60 seconds. https://api.hypixel.net/skyblock/auctions_ended

Auctions by player, profile, or auction uuid
https://api.hypixel.net/skyblock/auction?key= API Key &player= Player UUID https://api.hypixel.net/skyblock/auction?key= API Key &profile= Profile UUID https://api.hypixel.net/skyblock/auction?key= API Key &uuid= Auction UUID

Getting Bazaar data
https://api.hypixel.net/skyblock/bazaar

Getting Player Profiles data
https://api.hypixel.net/skyblock/profiles?key= API Key &uuid= Profile UUID

Getting Profiles' name and UUID
https://api.hypixel.net/player?key= API Key &name= Player Name https://api.hypixel.net/player?key= API Key &uuid= Player UUID
 * Profile UUID
 * : "58908872d5db4c798c438b24dd5c7ebb" (example)
 * : "Pear" (example)
 * Profile UUID
 * : "58908872d5db4c798c438b24dd5c7ebb" (example)
 * : "Pear" (example)
 * : "Pear" (example)

Getting the location of a player
https://api.hypixel.net/status?key= API Key &uuid= Player UUID


 * : true (example)
 * : "SKYBLOCK" (example) (list of GameTypes)
 * : "dynamic" (example)
 * : "dynamic" (example)

This method can be used for retrieving the location of the player. For example, 'dynamic' means that player is on a Private Island.