Bazaar

All API requests require an X-API-Key header. Get your key from the Developer Dashboard.

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/..."

See Authentication for details on key formats and tier limits.

GET /v1/bazaar

Returns bazaar product data from the Hypixel API. Use the mode parameter to control the response format. Cache: 5 seconds

Query parameters

Parameter	Type	Default	Description
`mode`	string	`full`	Response mode: `full`, `list`, `item`, or `flips`
`id`	string	—	Bazaar item ID (required when `mode=item`)
`limit`	integer	`20`	Max results for `mode=flips` (1–100)
`minPrice`	integer	`50000`	Minimum instant-sell price for `mode=flips`
`tax`	number	`0.01125`	Bazaar sell tax used in margin math for `mode=flips` (0–0.1). Default assumes one level of the Bazaar Flipper perk; raise it (e.g. `0.0225` under Mayor Aura) to match your account.
`budget`	integer	`5000000`	Reference coin budget used to probe order-book depth / position sizing for `mode=flips`

mode=full

Returns all bazaar products with raw Hypixel data.

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

const response = await fetch("https://api.skytools.app/v1/bazaar?mode=full", {
  headers: { "X-API-Key": "sk_your_key_here" },
});
const { data } = await response.json();
console.log(Object.keys(data.products).length, "products");

import requests

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

{
  "success": true,
  "data": {
    "lastUpdated": 1706000000000,
    "products": {
      "DIAMOND": {
        "product_id": "DIAMOND",
        "quick_status": {
          "sellPrice": 7.5,
          "buyPrice": 8.1,
          "sellVolume": 1234567,
          "buyVolume": 987654,
          "sellMovingWeek": 50000000,
          "buyMovingWeek": 45000000,
          "sellOrders": 150,
          "buyOrders": 200
        }
      }
    }
  },
  "meta": { "cached": false, "api_version": "v1" }
}

This returns ~1,500 products. If you only need item IDs, use mode=list to save bandwidth.

mode=list

Returns a sorted array of all active bazaar item IDs (items with non-zero prices).

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

{
  "success": true,
  "data": {
    "count": 1200,
    "items": [
      { "id": "ABSOLUTE_ENDER_PEARL" },
      { "id": "ACACIA_FENCE" }
    ]
  },
  "meta": { "cached": false, "api_version": "v1" }
}

mode=item

Returns processed data for a single item with spread calculations.

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

{
  "success": true,
  "data": {
    "id": "DIAMOND",
    "sellPrice": 7.5,
    "buyPrice": 8.1,
    "sellVolume": 1234567,
    "buyVolume": 987654,
    "spread": 0.6,
    "spreadPercent": 8.0,
    "sellMovingWeek": 50000000,
    "buyMovingWeek": 45000000
  },
  "meta": { "cached": false, "api_version": "v1" }
}

Field	Type	Description
`sellPrice`	number	Instant-sell price (what you get selling)
`buyPrice`	number	Instant-buy price (what you pay buying)
`spread`	number	`buyPrice - sellPrice`
`spreadPercent`	number	`(spread / sellPrice) * 100`
`sellVolume` / `buyVolume`	number	Current order volume
`sellMovingWeek` / `buyMovingWeek`	number	7-day moving trade volume

mode=flips

Returns the top bazaar flip opportunities, ranked by a composite score rather than raw spread.

Changed June 2026. Flips were previously sorted by spreadPercent and filtered only on sell price (≥ 50,000) and volume (≥ 10,000). They are now ranked by a composite score that blends after-tax margin, real weekly liquidity, price stability (trend signals), demand pressure (buy vs sell flow), and order-book depth — which surfaces genuinely flippable items instead of thin or manipulated walls. All previously returned fields are still present, so existing integrations keep working, but the set of items and their ordering have changed, and many new fields were added (see table below).

Items are filtered to: instant-sell price ≥ minPrice (default 50,000), positive after-tax margin, after-tax margin ≤ 100% (drops manipulated spreads), weekly throughput ≥ 60,000 units, and at least 5 buy and 5 sell orders (a real two-sided market). Results are sorted by score descending.

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

{
  "success": true,
  "data": {
    "count": 5,
    "tax": 0.01125,
    "refBudget": 5000000,
    "items": [
      {
        "id": "ENCHANTMENT_ULTIMATE_FATAL_TEMPO_1",
        "sellPrice": 100000,
        "buyPrice": 120000,
        "sellVolume": 50000,
        "buyVolume": 45000,
        "sellOrders": 42,
        "buyOrders": 60,
        "spread": 20000,
        "spreadPercent": 20.0,
        "sellMovingWeek": 5000000,
        "buyMovingWeek": 4500000,
        "netMargin": 18650,
        "netMarginPercent": 18.65,
        "weeklyThroughput": 4500000,
        "demandRatio": 0.9,
        "depthAdjMarginPercent": 16.2,
        "maxPositionCoins": 42000000,
        "profitPerHour": 600160,
        "score": 142.87,
        "riskTier": "medium",
        "trendSignal": "stable",
        "changePercent24h": 2.3
      }
    ]
  },
  "meta": { "cached": false, "api_version": "v1" }
}

The top-level tax and refBudget echo back the values used for the calculation (the request value, or the default).

Field	Type	Description
`sellPrice` / `buyPrice`	number	Instant-sell / instant-buy price
`sellOrders` / `buyOrders`	integer	Number of open sell / buy orders
`spread` / `spreadPercent`	number	Raw gross spread and its percentage
`sellMovingWeek` / `buyMovingWeek`	number	7-day moving trade volume
`netMargin`	number	After-tax profit per item: `buyPrice * (1 - tax) - sellPrice`
`netMarginPercent`	number	`netMargin` as a percentage of `sellPrice`
`weeklyThroughput`	number	Real liquidity floor: `min(buyMovingWeek, sellMovingWeek)`
`demandRatio`	number	Weekly buy flow ÷ sell flow. `> 1` = demand-heavy, `< 1` = oversupplied
`depthAdjMarginPercent`	number	After-tax margin that survives once you size up to `budget`, walking the order book
`maxPositionCoins`	integer	Coins you can realistically deploy round-trip given current book depth
`profitPerHour`	integer	Estimated coins/hour for a solo flipper (throughput × margin × realistic market capture)
`score`	number	Composite ranking score (higher is better) — the default sort key
`riskTier`	string	`low`, `medium`, or `high` — overall risk from volatility, liquidity, demand and depth
`trendSignal`	string \| null	Price trend: `rising`, `falling`, `stable`, or `null` if no trend data
`changePercent24h`	number \| null	24-hour price change percent, or `null` if no trend data

GET /v1/bazaar/trends

Returns pre-computed trend signals for all bazaar items. Updated every 5 minutes. Cache: 1 minute

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/bazaar/trends"

{
  "success": true,
  "data": {
    "count": 1487,
    "trends": { ... },
    "computed_at": "2026-06-07T12:00:00Z"
  },
  "meta": { "cached": false, "api_version": "v1" }
}

Field	Type	Description
`count`	integer	Number of items with trend signals
`trends`	object	Map of item ID → trend data (`signal`, `sma7`, `sma24`, `emaShort`, `changePercent24h`)
`computed_at`	string \| null	ISO timestamp of the last trend computation

Trend data is computed on-server from 5-minute bazaar snapshots. It includes price movement signals across multiple timeframes.

Errors

Code	HTTP Status	When
`NOT_FOUND`	404	`mode=item` with an invalid or non-existent `id`
`BAD_REQUEST`	400	Invalid `mode` value or missing `id` for item mode

Getting started

Guides

GET /v1/bazaar

Query parameters

mode=full

mode=list

mode=item

mode=flips

GET /v1/bazaar/trends

Errors