@breezil/hypixel-apiA typed Hypixel API client

Fetching, caching, rate-limit handling, and an always-on computed stats layer, so you can call hypixel.player.get("Notch") instead of wiring it all up by hand.

Get Started

API Reference

Computed Layer

View on GitHub

⚡

Typed endpoints

Subdomain-organised groups for player, guild, network, resources, SkyBlock, and housing. Pass an IGN or a UUID to any player-shaped method; names resolve automatically.

🧮

Always-on computed stats

Every result carries a separate .computed namespace with levels, prestiges, FKDR/KDR/WLR, titles, per-game rates, and "how much more for the next milestone" counters. Raw stays raw.

🧩

Strict-raw parsed results

Every endpoint returns a readonly, fully-typed object from @breezil/hypixel-parsers, re-exported here. Computed values never overwrite raw fields.

🔒

TTL cache and single-flight

A built-in TTL cache, single-flight de-duplication, a 16-slot concurrency cap, and a header-driven rate-limit gate that queues instead of dropping.

🛡️

Cooldown aware

Distinguishes the per-player cooldown 429 from real rate limits, with a stall-proof per-attempt deadline that retries genuine stalls but never the cooldown.

🔌

Standalone or embedded

Injected config (key, object, or live source) and injected identity layer with pluggable persistence, so the client runs alone or inside a host like the Breezil proxy.