archived2022

Bazaar Tracker

A market intelligence system for the Hypixel Skyblock bazaar economy, combining a long-running data ingestion pipeline (2019–present) with trend analysis, predictive signals, and a Discord bot interface.

Node.jsTypeScriptPostgreSQLDiscord.jsNext.jsChart.js

Problem

Bazaar markets exhibit high-frequency volatility driven by player behaviour, patch events, and seasonal patterns. Without historical data and signal extraction, profitable positions are indistinguishable from noise. Most publicly available tools offer only current snapshots.

What it does

Bazaar Tracker maintains a continuous time-series database of item prices, order book states, and volume metrics. A set of analytical routines identify trend breakpoints, liquidity conditions, and historical analogues. The Discord bot exposes this analysis in a structured, query-driven interface accessible to end users.

Architecture

Bazaar Tracker operates as a continuous data ingestion system. A background process polls the Hypixel API at regular intervals, storing time-stamped snapshots of the full bazaar order book to a PostgreSQL database. A separate analytical layer runs asynchronously, computing derived metrics — moving averages, volatility estimates, order book depth ratios — and storing these alongside the raw snapshots. The Discord bot is a query interface over this analytical layer. Users issue structured commands to retrieve current state, historical ranges, trend summaries, or regime classifications for specific items.

Technical implementation

  • Continuous ingestion pipeline polling Hypixel API with backoff and error recovery
  • PostgreSQL time-series schema with efficient range query patterns
  • Analytical layer computing moving averages, volatility, and order book metrics
  • Market regime classifier: trending, mean-reverting, illiquid, manipulated
  • Discord.js bot with structured command interface and pagination
  • Next.js dashboard for visual inspection of historical data
  • Historical dataset covering 2019 to present — approximately 2TB of raw snapshots

Challenges & constraints

The primary challenge is signal extraction from a noisy, adversarially-influenced environment. Bazaar prices are manipulated by large players who can move markets deliberately. A naive trend signal will track manipulations as well as genuine trends. The regime classifier attempts to distinguish between organic price movement and artificial manipulation by looking at order book structure: genuine trends are accompanied by depth; manipulation typically involves thin order books on one side. The historical dataset itself presented storage and query challenges. Naive storage of full order book snapshots at high frequency produces extremely large tables. The current schema uses compression and selective retention — full snapshots are archived, but the analytical layer retains only derived metrics in the hot path.

Systems thinking note

The Hypixel Skyblock bazaar is a useful laboratory for applied economics. The trading population is large (millions of players), the environment is structured (fixed rules, visible order books), and the data is accessible. These conditions make it possible to apply market microstructure reasoning in a context where the ground truth is observable — which is not always the case in real financial markets. The behavioural patterns that emerge — front-running, spoofing, momentum chasing, mean reversion trading — are recognisable from financial economics literature. The bazaar is not a toy; it is a small, fast, observable market that allows empirical investigation of market dynamics at low cost.

Stack

Node.jsTypeScriptPostgreSQLDiscord.jsNext.jsChart.js

Tags

EconomicsMarket systemsDataPredictionDiscord

Commit history

Bazaar Tracker5 commits

Full commit log for this repository, most recent first.

No commits to display.

Repository

mrailouis/bazaar-tracker

Commits shown
5
Most recent
22 Apr 2026
Oldest shown
10 Apr 2026