SkyTools API

The SkyTools API gives you programmatic access to real-time and historical Hypixel SkyBlock data — bazaar prices, auction listings, player profiles, net worth breakdowns, items, collections, mayors, fire sales, guilds, and crafting recipes. Base URL

https://api.skytools.app/v1

Quick start

All SkyTools accounts — including Free tier — can create API keys.

Create a free account at skytools.app
Generate an API key in the Developer Dashboard
Start making requests:

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/bazaar?mode=list"

const response = await fetch("https://api.skytools.app/v1/bazaar?mode=list", {
  headers: { "X-API-Key": "sk_your_key_here" },
});
const { success, data, meta } = await response.json();
console.log(data.items);

import requests

response = requests.get(
    "https://api.skytools.app/v1/bazaar",
    params={"mode": "list"},
    headers={"X-API-Key": "sk_your_key_here"},
)
data = response.json()
print(data["data"]["items"])

Response format

Every response follows a consistent JSON envelope:

{
  "success": true,
  "data": { ... },
  "meta": {
    "cached": false,
    "api_version": "v1"
  }
}

When serving stale cached data, meta includes "stale": true and "age_seconds". See Error Codes for details.

Endpoints

Bazaar

Real-time prices, flip opportunities, and trend signals.

Bazaar History

Historical price snapshots from 1 hour to 90 days.

Auctions

Paginated active auction listings.

Lowest BINs

Lowest Buy It Now price for every auctioned item.

Player Profiles

Profiles, net worth, inventories, and museum data.

Items

Complete SkyBlock item database.

Collections

Collection categories, tiers, and unlock requirements.

Mayor

Current mayor, perks, and election history.

Fire Sales

Active fire sales and historical sale data.

Guild

Guild lookup by name or player.

Recipes

Crafting recipes for SkyBlock items.

Rate limits

Tier	Limit	Price
Free	60 req/min	$0
Starter	120 req/min	$5.99/mo
Pro	300 req/min	$9.99/mo

See Rate Limits for details on headers and retry strategies.

Resources

Authentication — API key setup and usage
Rate Limits — Quotas, headers, and optimization tips
Error Codes — Complete error reference with troubleshooting
Developer Dashboard — Manage API keys and view usage stats

Getting started

Guides

Quick start

Response format

Endpoints

Bazaar

Bazaar History

Auctions

Lowest BINs

Player Profiles

Items

Collections

Mayor

Fire Sales

Guild

Recipes

Rate limits

Resources