Game API Reference

RESTful API for the Aetheria MMO platform — world data, player services, economy & matchmaking

Base URL https://api.aetheriacollective.com/v2

99.97%

Uptime (30d)

14ms

Avg Latency

Endpoints

2.4M

Calls / Day

Authentication

BEARER TOKEN

All API requests require authentication via Bearer token in the Authorization header. Tokens are issued through the Developer Portal and are scoped to specific permissions.

Authorization: Bearer act_live_k8x7m2p4n9...

Core Endpoints

GET /worlds List all active world shards

// Response 200
{
  "worlds": [
    {
      "id": "aetheria-eu-1",
      "region": "eu-central",
      "players_online": 1247,
      "status": "operational",
      "version": "3.2.1"
    }
  ],
  "total": 8
}

GET /players/{player_id} Get player profile & stats

// Response 200
{
  "player_id": "usr_9k2m4x8p",
  "display_name": "Stormweaver",
  "guild": "Order of the Silver Dawn",
  "level": 67,
  "class": "Elementalist",
  "playtime_hours": 842,
  "last_seen": "2026-03-15T10:42:00Z"
}

POST /matchmaking/queue Join PvP matchmaking queue

// Request body
{
  "player_id": "usr_9k2m4x8p",
  "mode": "ranked_3v3",
  "preferred_region": "eu-central"
}

// Response 202
{
  "queue_id": "q_7f3k9m2x",
  "estimated_wait": 45,
  "position": 12
}

GET /economy/market Current marketplace listings

// Response 200 (paginated)
{
  "listings": [
    {
      "item": "Void Crystal Shard",
      "rarity": "legendary",
      "price_gold": 15200,
      "seller": "usr_3n8x2k4m"
    }
  ],
  "page": 1,
  "total_pages": 247
}

PUT /guilds/{guild_id} Update guild settings

DEL /players/{player_id}/sessions Force logout all sessions

Rate Limits

Tier	Requests / min	Burst	Daily limit
Free	60	10	10,000
Developer	300	50	100,000
Production	3,000	500	Unlimited

Error Codes

Code	Meaning	Action
401	Invalid or expired token	Re-authenticate via /auth/token
403	Insufficient permissions	Check token scopes
429	Rate limit exceeded	Back off, check Retry-After header
503	Shard maintenance	Retry after maintenance window

REQUEST API ACCESS

Enter your developer credentials to receive an API key. Production keys are issued after review.

API keys are typically issued within 24 hours