Hypixel SkyBlock API
Hypixel SkyBlock — auctions, bazaar, profiles, museum, garden, bingo, fire sales, and SkyBlock-specific reference data.
OpenAPI Specification
openapi: 3.0.3
info:
title: Hypixel Public Housing SkyBlock API
x-logo:
url: https://api.hypixel.net/assets/images/logo.png
altText: Hypixel Logo
href: '#'
description: "# Introduction\nThis is the official Hypixel API documentation. [Hypixel Website](https://hypixel.net/) - [GitHub Repo](https://github.com/HypixelDev/PublicAPI) - [API Help Forum](https://hypixel.net/forums/api-help.111/)\n\nAll use of the API must conform to the [API policies](https://developer.hypixel.net/policies), violation of these policies may lead to applications being revoked or users banned from the API.\n## Limits\nAPI keys are limited to a maximum amount of requests per 5 minute intervals. These limits will depend on the type of application that the key is assigned to.\n\nEndpoints which require the use of an API key will also respond with headers to assist with managing the rate limit:\n- 'RateLimit-Limit' - The limit of requests per minute for the provided API key.\n- 'RateLimit-Remaining' - The remaining amount of requests allowed for the current minute.\n- 'RateLimit-Reset' - The amount of seconds until the next minute and the reset of the API key usages.\n\n## GameTypes\n| ID | Type Name | Database Name | Clean Name |\n |----|----------------|---------------|----------------------|\n | 2 | QUAKECRAFT | Quake | Quake |\n | 3 | WALLS | Walls | Walls |\n | 4 | PAINTBALL | Paintball | Paintball |\n | 5 | SURVIVAL_GAMES | HungerGames | Blitz Survival Games |\n | 6 | TNTGAMES | TNTGames | TNT Games |\n | 7 | VAMPIREZ | VampireZ | VampireZ |\n | 13 | WALLS3 | Walls3 | Mega Walls |\n | 14 | ARCADE | Arcade | Arcade |\n | 17 | ARENA | Arena | Arena |\n | 20 | UHC | UHC | UHC Champions |\n | 21 | MCGO | MCGO | Cops and Crims |\n | 23 | BATTLEGROUND | Battleground | Warlords |\n | 24 | SUPER_SMASH | SuperSmash | Smash Heroes |\n | 25 | GINGERBREAD | GingerBread | Turbo Kart Racers |\n | 26 | HOUSING | Housing | Housing |\n | 51 | SKYWARS | SkyWars | SkyWars |\n | 52 | TRUE_COMBAT | TrueCombat | Crazy Walls |\n | 54 | SPEED_UHC | SpeedUHC | Speed UHC |\n | 55 | SKYCLASH | SkyClash | SkyClash |\n | 56 | LEGACY | Legacy | Classic Games |\n | 57 | PROTOTYPE | Prototype | Prototype |\n | 58 | BEDWARS | Bedwars | Bed Wars |\n | 59 | MURDER_MYSTERY | MurderMystery | Murder Mystery |\n | 60 | BUILD_BATTLE | BuildBattle | Build Battle |\n | 61 | DUELS | Duels | Duels |\n | 63 | SKYBLOCK | SkyBlock | SkyBlock |\n | 64 | PIT | Pit | Pit |\n | 65 | REPLAY | Replay | Replay |\n | 67 | SMP | SMP | SMP |\n | 68 | WOOL_GAMES | WoolGames | Wool Wars |\n\n### Storage\nGames store their respective stats and data in a Player's `stats` collection. The game's specific data is held within a JSON object named after it's `Database Name` (seen above.)\n### GameType Notes\n* Clean names are what is displayed to the user when referencing the name.\n* Database names or IDs are used when the API references a specific GameType.\n## Notes\n\n### Date and Time\nGenerally dates are stored as a Unix Epoch times in milliseconds.\n### Response Format\nResponses are served in JSON format.\n### UUID Parameters\nAll uuid parameters support both dashed and undashed versions.\n### SkyBlock items and inventories\nItems and inventory data are stored as a base64 encoded string containing gzipped nbt data.\nIf a method is missing important information about an item or inventory, you should try checking this!\n>Note: the base64 string may contain a unicode escape for non-alphabetical symbols, and some programming languages may have silent defects when interpreting the string. \n\n# Authentication\n\n<!-- ReDoc-Inject: <security-definitions> -->"
version: v2
termsOfService: https://hypixel.net/tos
contact:
name: Hypixel Support
url: https://developer.hypixel.net
x-jentic-source-url: https://api.hypixel.net/
x-generated-from: jentic-public-apis
x-last-validated: '2026-05-30'
servers:
- url: https://api.hypixel.net
security:
- ApiKey: []
tags:
- name: SkyBlock
description: Hypixel SkyBlock — auctions, bazaar, profiles, museum, garden, bingo, fire sales, and SkyBlock-specific reference data.
paths:
/v2/resources/skyblock/collections:
get:
summary: Hypixel Collections
description: Information regarding Collections in the SkyBlock game.
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
version:
type: string
example: 0.11.22
collections:
type: object
examples:
GetResourcesSkyblockCollections200Example:
summary: Default getResourcesSkyblockCollections 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
version: 0.11.22
collections: {}
operationId: getResourcesSkyblockCollections
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/resources/skyblock/skills:
get:
summary: Hypixel Skills
description: Information regarding skills in the SkyBlock game.
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
version:
type: string
example: 0.11.22
skills:
type: object
examples:
GetResourcesSkyblockSkills200Example:
summary: Default getResourcesSkyblockSkills 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
version: 0.11.22
skills: {}
operationId: getResourcesSkyblockSkills
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/resources/skyblock/items:
get:
summary: Hypixel Items
description: Information regarding items in the SkyBlock game.
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
items:
type: array
items:
$ref: '#/components/schemas/SkyBlockItem'
examples:
GetResourcesSkyblockItems200Example:
summary: Default getResourcesSkyblockItems 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
items:
- example
operationId: getResourcesSkyblockItems
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/resources/skyblock/election:
get:
summary: Hypixel Election and Mayor
description: Information regarding the current mayor and ongoing election in SkyBlock.
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
mayor:
type: object
description: Data regarding the current mayor
current:
type: object
description: Data regarding the current election, will not be provided if there is no open election ongoing
examples:
GetResourcesSkyblockElection200Example:
summary: Default getResourcesSkyblockElection 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
mayor: {}
current: {}
operationId: getResourcesSkyblockElection
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/resources/skyblock/bingo:
get:
summary: Hypixel Current Bingo Event
description: Information regarding the current bingo event and its goals.
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
required:
- success
- lastUpdated
- id
- name
- start
- end
- modifier
- goals
properties:
success:
type: boolean
lastUpdated:
type: number
format: int64
description: The unix milliseconds timestamp of the last time this data was updated
id:
type: number
format: int32
description: The current bingo event ID, increments by 1 for each bingo hosted
example: 27
name:
type: string
description: The display name for the current bingo event
example: March 2024
start:
type: number
format: int64
description: The start time of the current bingo event in unix milliseconds
example: 1709269200000
end:
type: number
format: int64
description: The end time of the current bingo event in unix milliseconds
example: 1709874000000
modifier:
type: string
enum:
- NORMAL
- EXTREME
- SECRET
description: The modifier for the current bingo event
example: NORMAL
goals:
type: array
description: The goals for the current bingo event, as well as their progress
items:
type: object
required:
- id
- name
properties:
id:
description: The backend ID for this goal
type: string
name:
description: The user friendly display name for this goal
type: string
lore:
description: Description of this goal
type: string
fullLore:
description: The full description of this goal
type: array
tiers:
description: The tiers of this goal, if a global goal
type: array
items:
type: number
format: int64
progress:
description: The global progress of this goal
type: number
format: int64
requiredAmount:
description: The required amount for this specific goal
type: number
format: int32
examples:
GetResourcesSkyblockBingo200Example:
summary: Default getResourcesSkyblockBingo 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
id: 27
name: March 2024
start: 1709269200000
end: 1709874000000
operationId: getResourcesSkyblockBingo
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/news:
get:
summary: Hypixel News
tags:
- SkyBlock
security:
- ApiKey: []
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
items:
items:
example:
item:
material: DIAMOND
link: https://hypixel.net
title: SkyBlock v0.11
text: 15th January 2021
examples:
GetSkyblockNews200Example:
summary: Default getSkyblockNews 200 response
x-microcks-default: true
value:
success: true
items: example
'403':
$ref: '#/components/responses/InvalidKey'
'429':
$ref: '#/components/responses/RateLimited'
operationId: getSkyblockNews
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: News
/v2/skyblock/auction:
get:
summary: Hypixel Request Auction(s) by the Auction UUID, Player UUID, or Profile UUID.
description: Returns the auctions selected by the provided query. Only one query parameter can be used in a single request, and cannot be filtered by multiple.
tags:
- SkyBlock
security:
- ApiKey: []
parameters:
- in: query
name: uuid
description: The auction UUID that you wish to request
schema:
type: string
example: ad8fefaa8351454bb739a4eaa872173f
- in: query
name: player
description: The player UUID that you wish to request
schema:
type: string
example: example
- in: query
name: profile
description: The profile UUID that you wish to request
schema:
type: string
example: a1b2c3d4-1234-5678-9abc-def012345678
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
auctions:
type: array
items:
$ref: '#/components/schemas/SkyBlockAuction'
examples:
GetSkyblockAuction200Example:
summary: Default getSkyblockAuction 200 response
x-microcks-default: true
value:
success: true
auctions:
- example
'400':
$ref: '#/components/responses/DataMissing'
'403':
$ref: '#/components/responses/InvalidKey'
'422':
$ref: '#/components/responses/MalformedData'
'429':
$ref: '#/components/responses/RateLimited'
operationId: getSkyblockAuction
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/auctions:
get:
summary: Hypixel Active Auctions
description: Returns the currently active auctions sorted by last updated first and paginated.
tags:
- SkyBlock
parameters:
- in: query
name: page
schema:
type: number
default: 0
example: 0
description: The page parameter.
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
page:
type: number
totalPages:
type: number
example: 32
totalAuctions:
type: number
example: 31267
lastUpdated:
type: number
format: int64
example: 1571065561345
auctions:
type: array
items:
$ref: '#/components/schemas/SkyBlockAuction'
examples:
GetSkyblockAuctions200Example:
summary: Default getSkyblockAuctions 200 response
x-microcks-default: true
value:
success: true
page: 1.0
totalPages: 32
totalAuctions: 31267
lastUpdated: 1571065561345
auctions:
- example
'404':
$ref: '#/components/responses/MissingPage'
'422':
$ref: '#/components/responses/InvalidPage'
'503':
$ref: '#/components/responses/NotPopulated'
operationId: getSkyblockAuctions
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/auctions_ended:
get:
summary: Hypixel Recently Ended Auctions
description: SkyBlock auctions which ended in the last 60 seconds.
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
format: int64
example: 1607456463916
auctions:
type: array
items:
example:
auction_id: 015fe0c67e6041e69797bbe0c2725a21
seller: fc76242bf64a4698ae0ebc136d900929
seller_profile: 85b96cd3e73e4580b8379162ec059141
buyer: c1eff55de0d24ec6b44848799e9323ba
buyer_profile: a3e1c076533a40a58085e7f43a598bf3
timestamp: 1607456400329
price: 190000
bin: true
item_bytes: H4sIAAAAAAAAAEWR3W7TQBCFx2mBxKgtSH2ArUACZKL6L9jtndUYBdHQyGlV7qq1PXZX9U+03kB6yYNw7ffwo/AgiHEC4m7mmz1nz87qACPQhA4A2gAGItUGGjy5qNeV0nTYUzzX4PlNFUvkDzwuUNuD0Uyk+LHgeUOi3zo8S0WzKvjjCPYva4lDoofwsmu9KS95juesaxPDN+GY0FJJrHJ1v4PWxKTDAfGQy4rQB8M2WVKLqqHGy2RdsrKuGoWSPYiiaNjbS/yGBQ3RMo3+TF0Vj+/I5NXWj+2u7Acr0hCbmGbfbdWgd60/5xtmOBM4JPq5p9sofY43W4tfP3+wfyn/++Bfn+91nYJBxS0VlLQoMFGCIvYu6FnvXcenindtMQ++htMT8u11dPH1vWiYUFiyhFcsRiYxq2WO6Qm86NozUkRBFLLl7VU0HcL+F14iHNAg4rRuyYINgg5H4UZJHiglRbxW2AxhVEuRi+qa53CwnF0t7hY30cUsWIbD/jdBj4JP0zC6ozBkul4Teu34Tua7vj124tQduz73xtxOvbGVoZtMbN/xnIyMlSixUbxcwZFln/qn9DX2ue2wxRxgAE93q6b3wR9BYJa/RAIAAA==
examples:
GetSkyblockAuctionsEnded200Example:
summary: Default getSkyblockAuctionsEnded 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1607456463916
auctions:
- auction_id: 015fe0c67e6041e69797bbe0c2725a21
seller: fc76242bf64a4698ae0ebc136d900929
seller_profile: 85b96cd3e73e4580b8379162ec059141
buyer: c1eff55de0d24ec6b44848799e9323ba
buyer_profile: a3e1c076533a40a58085e7f43a598bf3
timestamp: 1607456400329
price: 190000
bin: true
item_bytes: H4sIAAAAAAAAAEWR3W7TQBCFx2mBxKgtSH2ArUACZKL6L9jtndUYBdHQyGlV7qq1PXZX9U+03kB6yYNw7ffwo/AgiHEC4m7mmz1nz87qACPQhA4A2gAGItUGGjy5qNeV0nTYUzzX4PlNFUvkDzwuUNuD0Uyk+LHgeUOi3zo8S0WzKvjjCPYva4lDoofwsmu9KS95juesaxPDN+GY0FJJrHJ1v4PWxKTDAfGQy4rQB8M2WVKLqqHGy2RdsrKuGoWSPYiiaNjbS/yGBQ3RMo3+TF0Vj+/I5NXWj+2u7Acr0hCbmGbfbdWgd60/5xtmOBM4JPq5p9sofY43W4tfP3+wfyn/++Bfn+91nYJBxS0VlLQoMFGCIvYu6FnvXcenindtMQ++htMT8u11dPH1vWiYUFiyhFcsRiYxq2WO6Qm86NozUkRBFLLl7VU0HcL+F14iHNAg4rRuyYINgg5H4UZJHiglRbxW2AxhVEuRi+qa53CwnF0t7hY30cUsWIbD/jdBj4JP0zC6ozBkul4Teu34Tua7vj124tQduz73xtxOvbGVoZtMbN/xnIyMlSixUbxcwZFln/qn9DX2ue2wxRxgAE93q6b3wR9BYJa/RAIAAA==
operationId: getSkyblockAuctionsEnded
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/bazaar:
get:
summary: Hypixel Bazaar
description: "Returns the list of products along with their sell summary, buy summary and quick status.\n ### Product Description\n The returned product info has 3 main fields:\n - `buy_summary`\n - `sell_summary`\n - `quick_status`\n\n`buy_summary` and `sell_summary` are the current top 30 orders for each transaction type (in-game example: [Stock of Stonks](https://i.imgur.com/SjRONxq.png)).\n\n`quick_status` is a computed summary of the live state of the product (used for advanced mode view in the bazaar):\n- `sellVolume` and `buyVolume` are the sum of item amounts in all orders.\n - `sellPrice` and `buyPrice` are the weighted average of the top 2% of orders by volume.\n - `movingWeek` is the historic transacted volume from last 7d + live state.\n - `sellOrders` and `buyOrders` are the count of active orders. "
tags:
- SkyBlock
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
format: int64
example: 1590854517479
products:
type: object
example:
INK_SACK:3:
product_id: INK_SACK:3
sell_summary:
- amount: 20569
pricePerUnit: 4.2
orders: 1
- amount: 140326
pricePerUnit: 3.8
orders: 2
buy_summary:
- amount: 640
pricePerUnit: 4.8
orders: 1
- amount: 640
pricePerUnit: 4.9
orders: 1
- amount: 25957
pricePerUnit: 5
orders: 3
quick_status:
productId: INK_SACK:3
sellPrice: 4.2
sellVolume: 409855
sellMovingWeek: 8301075
sellOrders: 11
buyPrice: 4.99260315136572
buyVolume: 1254854
buyMovingWeek: 5830656
buyOrders: 85
examples:
GetSkyblockBazaar200Example:
summary: Default getSkyblockBazaar 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1590854517479
products:
INK_SACK:3:
product_id: INK_SACK:3
sell_summary:
- amount: 20569
pricePerUnit: 4.2
orders: 1
- amount: 140326
pricePerUnit: 3.8
orders: 2
buy_summary:
- amount: 640
pricePerUnit: 4.8
orders: 1
- amount: 640
pricePerUnit: 4.9
orders: 1
- amount: 25957
pricePerUnit: 5
orders: 3
quick_status:
productId: INK_SACK:3
sellPrice: 4.2
sellVolume: 409855
sellMovingWeek: 8301075
sellOrders: 11
buyPrice: 4.99260315136572
buyVolume: 1254854
buyMovingWeek: 5830656
buyOrders: 85
'503':
$ref: '#/components/responses/NotPopulated'
operationId: getSkyblockBazaar
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/profile:
get:
summary: Hypixel Profile by UUID
description: SkyBlock profile data, such as stats, objectives etc. The data returned can differ depending on the players in-game API settings.
tags:
- SkyBlock
security:
- ApiKey: []
parameters:
- in: query
name: profile
schema:
type: string
format: uuid
example: ad8fefaa8351454bb739a4eaa872173f
description: The profile parameter.
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
profile:
$ref: '#/components/schemas/SkyBlockProfile'
examples:
GetSkyblockProfile200Example:
summary: Default getSkyblockProfile 200 response
x-microcks-default: true
value:
success: true
profile: a1b2c3d4-1234-5678-9abc-def012345678
'400':
$ref: '#/components/responses/DataMissing'
'403':
$ref: '#/components/responses/InvalidKey'
'422':
$ref: '#/components/responses/MalformedData'
'429':
$ref: '#/components/responses/RateLimited'
operationId: getSkyblockProfile
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/profiles:
get:
summary: Hypixel Profiles by Player
tags:
- SkyBlock
security:
- ApiKey: []
parameters:
- in: query
name: uuid
schema:
type: string
format: uuid
example: ad8fefaa8351454bb739a4eaa872173f
description: The uuid parameter.
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
profiles:
type: array
items:
$ref: '#/components/schemas/SkyBlockProfile'
examples:
GetSkyblockProfiles200Example:
summary: Default getSkyblockProfiles 200 response
x-microcks-default: true
value:
success: true
profiles:
- a1b2c3d4-1234-5678-9abc-def012345678
'400':
$ref: '#/components/responses/DataMissing'
'403':
$ref: '#/components/responses/InvalidKey'
'422':
$ref: '#/components/responses/MalformedData'
'429':
$ref: '#/components/responses/RateLimited'
operationId: getSkyblockProfiles
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Profiles by player
/v2/skyblock/museum:
get:
summary: Hypixel Museum Data by Profile ID
description: SkyBlock museum data for all members of the provided profile. The data returned can differ depending on the players in-game API settings.
tags:
- SkyBlock
security:
- ApiKey: []
parameters:
- in: query
name: profile
schema:
type: string
format: uuid
example: ad8fefaa8351454bb739a4eaa872173f
description: The profile parameter.
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
profile:
$ref: '#/components/schemas/SkyBlockMuseum'
examples:
GetSkyblockMuseum200Example:
summary: Default getSkyblockMuseum 200 response
x-microcks-default: true
value:
success: true
profile: a1b2c3d4-1234-5678-9abc-def012345678
'403':
$ref: '#/components/responses/InvalidKey'
'422':
$ref: '#/components/responses/MalformedData'
'429':
$ref: '#/components/responses/RateLimited'
operationId: getSkyblockMuseum
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/garden:
get:
summary: Hypixel Garden Data by Profile ID
description: SkyBlock garden data for the provided profile.
tags:
- SkyBlock
security:
- ApiKey: []
parameters:
- in: query
name: profile
schema:
type: string
format: uuid
example: ad8fefaa8351454bb739a4eaa872173f
description: The profile parameter.
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
garden:
$ref: '#/components/schemas/SkyBlockGarden'
examples:
GetSkyblockGarden200Example:
summary: Default getSkyblockGarden 200 response
x-microcks-default: true
value:
success: true
garden: example
'403':
$ref: '#/components/responses/InvalidKey'
'404':
$ref: '#/components/responses/NoResult'
'422':
$ref: '#/components/responses/MalformedData'
'429':
$ref: '#/components/responses/RateLimited'
operationId: getSkyblockGarden
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/skyblock/bingo:
get:
summary: Hypixel Bingo Data by Player
description: Bingo data for participated events of t
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hypixel/refs/heads/main/openapi/hypixel-skyblock-api-openapi.yml