K KKW SMPHow to play

KKW SMP API

Live server
data.

A read-only REST API for live status, player stats, teams, leaderboards, item prices, bounties, auctions and buy orders. Every response is JSON.BASE /v1

Introduction

Use GET requests with a key created in-game using /api. Keys are private; creating a new key revokes your previous one.

AuthenticationSend Authorization: Bearer YOUR_API_KEY. The X-API-Key header also works.
Rate limits120 requests per minute per key. Responses include remaining requests and reset time headers.

Try it

Paste a key generated with /api. It stays only in this browser.

ACCOUNT

GET/meYour API account

Returns the Minecraft account that owns the API key.

{ "ok": true, "account": { "uuid": "...", "name": "Player" } }

SERVER

GET/statusLive server status

Returns online players, maximum players, TPS and uptime. Cached for 10 seconds.

PLAYERS

GET/players/{player}Get a player

Returns balance, shards, combat, building and playtime statistics. Cached for 15 seconds.

TEAMS

GET/teams/{name}Get a team

Returns a team owner, members and friendly-fire setting.

LEADERBOARDS

GET/leaderboards/{category}Top players

Categories: money, shards, kills, deaths or playtime. Cached for 30 seconds.

ECONOMY

GET/pricesItem prices

Returns configured in-game shop buy and sell prices. Cached for 60 seconds.

GET/bountiesActive bounties

Returns active player bounties sorted by value.

AUCTIONS

GET/auctionsAuction house

Returns active Auction House listings with item, amount, seller, price and timestamp.

ORDERS

GET/ordersBuy orders

Returns all active buy orders.

GET/orders/mineYour buy orders

Returns only orders owned by your API account.

Errors

Errors use JSON: { "ok": false, "error": "...", "message": "..." }. Common statuses are 401 for invalid keys, 404 for an unknown route/player/team, 405 for non-GET requests and 429 for rate limits.