The Hardcore NetworkPure Hardcore · Minecraft first

Developer documentation · public JSON

Network
API.

Build with public, server-verified records from the Hardcore Minecraft Network. Browse endpoints, see the response format, and make your first request.

Open live API index Explore endpoints
GET requestsHTTPSOpen CORSETag support

Start here / 01

Your first request.

No key or account needed. Send a GET request to the versioned base URL.

Terminal
curl "https://hardcoreminecraft.net/api/v1/status"

Reference / Version 1

Find an endpoint.

All routes below accept GET and return JSON. Select “Open” to inspect a live response.

01

Server & world

Connection state, network totals, and the current world chapter.

GET/api/v1/statusOpen

Live server connection, online population, territory sync status, and current chapter.

No query parameters.

GET/api/v1/networkOpen

Public network-wide totals and current player population.

No query parameters.

GET/api/v1/chaptersOpen

Current world chapter and retained chapter history.

No query parameters.

02

Players & rankings

Find public profiles and query player-approved statistics.

GET/api/v1/playersOpen

Browse public player profiles.

  • limitOptional · 1–250 · defaults to 100
  • qOptional · search by player name
  • onlineOptional · set to 1 to show online players only
GET/api/v1/player?name={username}Open

Fetch one public profile and its enabled profile, gameplay, market, and history fields.

  • nameRequired · Minecraft username
GET/api/v1/leaderboardsOpen

Rank public players by survival, economy, combat, exploration, and lifetime metrics.

  • metricOptional · defaults to longest_survival_seconds
  • limitOptional · 1–250 · defaults to 100
Supported leaderboard metrics

longest_survival_seconds, current_streak_seconds, marks, souls, mob_kills, boss_kills, blocks_mined, souls_found, revivals_performed, times_revived, souls_spent_reviving, lives_sacrificed, playtime_seconds, deaths, player_kills, distance_traveled_meters, market_items_bought, market_items_sold, blocks_placed, diamonds_mined, ancient_cities_visited, trial_chambers_visited, nether_fortresses_discovered, end_cities_discovered, dragon_kills, wither_kills, warden_kills, vanilla_advancements_completed, marks_earned, marks_spent, souls_spent, clan_contributions, player_shop_revenue_marks, player_shop_sales

03

Clans

Public clan identity, relationships, and history.

GET/api/v1/clansOpen

Public clan roster summaries, leadership, recruitment, territory, and statistics.

  • limitOptional · 1–250 · defaults to 100
GET/api/v1/clan-relationsOpen

Public alliances and rivalries between public clans.

No query parameters.

GET/api/v1/clan-history?clan={uuid}Open

Public clan milestones and member or leadership changes. Omit clan to browse recent network-wide clan history.

  • clanOptional · clan UUID
  • limitOptional · 1–250 · defaults to 100
04

Market & community economy

Current resource prices, price history, community goals, and player listings.

GET/api/v1/marketOpen

Current public item prices, supply, and 24-hour movement.

  • limitOptional · 1–250 · defaults to 100
GET/api/v1/market-history?item_key={key}Open

Price and supply history with period summaries and aggregated trade volume.

  • item_keyRequired · current market item key
  • periodOptional · 1h, 24h, 7d, 30d, 90d, or all
  • limitOptional · up to 250 points
GET/api/v1/goalsOpen

Community contribution goals and progress.

  • limitOptional · up to 100
GET/api/v1/contractsOpen

Open player delivery contracts.

  • limitOptional · 1–250 · defaults to 100
GET/api/v1/shopsOpen

Open player shop listings and seller-published item details.

  • limitOptional · 1–250 · defaults to 100
05

Chronicle & activity

Public survival stories and published network events.

GET/api/v1/deathsOpen

Recent public death records with obituaries and survival streaks. Coordinates are excluded.

  • limitOptional · up to 100
GET/api/v1/revivalsOpen

Public revival records. Both players’ visibility settings must allow the record.

  • limitOptional · up to 100
GET/api/v1/memorialsOpen

Public Soul-funded memorial records.

  • limitOptional · up to 100
GET/api/v1/eventsOpen

Published world events and their current state.

  • limitOptional · up to 100
GET/api/v1/activityOpen

Privacy-filtered recent network activity, including public Dragon milestones.

  • limitOptional · 1–250 · defaults to 100
06

Dragon registry

Enabled lineages and privacy-filtered public Dragon egg records.

GET/api/v1/dragon-lineagesOpen

Enabled lineages, availability, incubation, and public guide details.

No query parameters.

GET/api/v1/dragonsOpen

Browse public registered eggs with optional lineage, owner, clan, state, generation, and date filters.

  • limitOptional · 1–250 · defaults to 100
  • lineage, owner, clan, status, generationOptional · combine as needed
  • date_from, date_toOptional · inclusive dates in YYYY-MM-DD format
GET/api/v1/dragons/{registry}Open

Fetch one public egg record by its positive registry number.

  • registryRequired · registry number in the URL
GET/api/v1/players/{uuid}/dragonsOpen

Browse eggs currently held by an eligible public player.

  • uuidRequired · player UUID
  • limitOptional · 1–250 · defaults to 100
GET/api/v1/clans/{uuid}/dragonsOpen

Browse eggs held by eligible public members of a public clan.

  • uuidRequired · clan UUID
  • limitOptional · 1–250 · defaults to 100
07

Territory

Public clan territory only. Personal claims and private locations are never returned.

GET/api/v1/territoryOpen

Without a world, list worlds with public territory. With a world key, return public clan-assigned chunks.

  • worldOptional · namespaced key such as minecraft:overworld
  • limitOptional · 1–250 · defaults to 100
GET/api/v1/territory-historyOpen

Public clan territory assignments, releases, and unclaims.

  • worldOptional · namespaced Minecraft world key
  • limitOptional · 1–250 · defaults to 100

Working with responses / 02

Small details.
Reliable integrations.

Response envelope

Predictable JSON.

Successful resources share a version, resource name, timestamp, data object or list, and metadata. The envelope timestamp is UTC ISO-8601; event timestamps are Unix seconds.

JSON · status response
{
  "api_version": "1",
  "resource": "status",
  "generated_at": "2026-09-30T12:00:00Z",
  "data": { "connected": true, "players_online": 12, "players_max": 100 },
  "meta": { "snapshot_fresh": true }
}
Browser example

Fetch from JavaScript.

Cross-origin reads are enabled. Check the HTTP status before using the response.

JavaScript
const response = await fetch(
  "https://hardcoreminecraft.net/api/v1/status"
);

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json();
console.log(result.data);
Caching & limits

Fresh when it matters.

Responses include an ETag and can be revalidated with If-None-Match. A matching response returns 304 Not Modified.

  • Market10 sec
  • Leaderboards60 sec
  • Market history5 min
  • Other resources30 sec

List limits default to 100 and are bounded at 250. Some activity and story feeds cap results at 100. Error responses are not cached.

Errors

Useful status codes.

  • 400Invalid or missing query parameter
  • 404Unknown resource or no public record
  • 405Only GET and OPTIONS are allowed

Error bodies include api_version and an error object with a stable code and message.

Public data only

Privacy follows the player.

Profiles and statistics follow player visibility settings. The API omits account identifiers, moderation data, home locations, personal claim locations, and exact death coordinates. Dragon records appear only when the current holder allows public profiles and gameplay statistics. Territory endpoints include public clan claims only.

Dragon Registry
Address copied