# LatamGameServers / LunaRust - Public API Reference for Assistants

This reference is intentionally limited to public, non-sensitive data.
No secrets, admin routes, tokens, or private infrastructure details are included.

## Domains
- https://latamgameservers.com
- https://lunarust.com
- API: https://webstatsapi.latamgs.com

## Public API Routes

### Health
- GET /health
  - Returns service health status.

### Servers
- GET /api/servers
  - Returns active server list and live stats.
- GET /api/servers/{server_id}
  - Returns server details, map info, and summary stats.
- GET /api/servers/{server_id}/kill-feed?limit=&offset=
  - Returns recent kill feed for a specific server.

### Leaderboards
- GET /api/leaderboard/{server_id}?limit=&offset=&sort=&wipe=&servers=
  - server_id can be a specific server or "all".
  - sort examples: kills, kdr, headshot_percent, elo, playtime_seconds.
  - wipe: all | current

### ELO
- GET /api/elo/daily-summary
- GET /api/elo/leaderboard?limit=&offset=
- GET /api/elo/player/{steam_id}

### Map data
- GET /api/rustmaps/{server_id}

### Plugin ingestion health
- GET /api/plugin-stats/health

## Data and Usage Guidance
- All timestamps should be treated as UTC unless explicit timezone context is returned.
- steam_id values are Steam64 IDs (17-digit strings).
- server_id values are stable identifiers (for example: caramelo, solonoob, lunax2).

## Safe-Agent Rules
- Never request, store, or expose credentials, bearer tokens, signatures, or private keys.
- Do not call admin/protected endpoints unless explicitly provided valid authorization.
- Use reasonable polling intervals and retry with exponential backoff on 429/5xx.
- Prefer limit/offset pagination over repeated full scans.

## Example Queries
- /api/servers
- /api/servers/caramelo
- /api/servers/caramelo/kill-feed?limit=50
- /api/leaderboard/all?limit=25&sort=kills&wipe=all
- /api/elo/leaderboard?limit=50

## Playbooks
- /agent-playbooks.txt