Garden Horizons API

The central data hub for the Grow A Garden Horizons ecosystem. Access real-time seed stock, gear availability, and weather patterns synced directly from Discord.

Authentication

This API is currently public for development. No API Key is required for GET requests. WebSocket connections are rate-limited to 5 concurrent sessions per IP.

Endpoints

GET /ghz

Returns the current snapshot of the garden state. Use this to hydrate your UI on initial load.

WS /ghz

Upgrades the connection to a persistent WebSocket. Emits a full gardenState object instantly whenever a change is detected in Discord.

Data Schema

Field Type Description
seeds Array<Item> List of available seeds containing name, emoji, and quantity.
gear Array<Item> List of available equipment containing name, emoji, and quantity.
weather Object Contains status, description, and timeframe data.

Live Tracker

Connect to the WebSocket to view real-time inventory and weather changes below.

OFFLINE

🌤️ Current Weather

Waiting...
--

🌱 Seed Shop

Waiting for data...

🛠️ Gear Shop

Waiting for data...
// Press 'Connect Tracker' to start listening