API Key Disclaimer
About sharing your EarthMC API key
The EarthMC API key saved here is only used for one thing: reading your own QuickShop data from EarthMC's shop API. It does not grant access to your Minecraft account, Discord account, inventory, money, town permissions, nation permissions, or any command that can change server state.
Why We Ask For It
EarthMC's public API does not expose a global shop list. The `/shop` endpoint only returns shops owned by the player whose API key is supplied. Saving your key lets EarthMC Observatory pull your own shop listings and combine them with other players who opted in.
That is how the global shops page is built: every listing comes from a player who chose to share their shop API access.
What The Key Is Used For
- Fetch your own EarthMC QuickShop listings from `https://api.earthmc.net/v4/shop`.
- Cache item, price, stock, type, and location data for those listings.
- Record price snapshots over time so the site can show historical market prices.
- Display your opted-in listings on the public shops page and related item views.
What Is Not Possible With It
- It cannot log in to your Minecraft account or Discord account.
- It cannot run commands, buy items, sell items, change prices, create shops, delete shops, or move money.
- It cannot read private messages, inventory contents, ender chest contents, homes, claims, town settings, or nation settings.
- It cannot fetch another player's shop data unless that player's own matching API key is saved.
- It cannot bypass EarthMC permissions or expose data the EarthMC API does not return.
Storage And Control
Saved keys are encrypted before they are stored in the database. The account page only shows metadata and the last four characters so you can identify which key was saved. We do not show the full key again after it is saved.
We do not rotate your EarthMC API key. These are server-issued keys and are expected to stay stable. You can delete your saved key from Account Settings at any time; deleting it removes the stored key and stops future shop pulls for that player.