API Reference

Economics and War API v1

Read-only. All responses are JSON. Authenticated endpoints require a scoped key sent asAuthorization: Bearer eaw_live_....

Public endpoints

GET/api/v1/nationspublicpublic.read

Paginated nation directory. Supports ?search=, ?region=, ?page=, ?limit=.

GET/api/v1/nations/{nation_id}publicpublic.read

Public profile of a single nation plus its alliance membership.

GET/api/v1/alliancespublicpublic.read

Alliance directory ordered by strength index.

GET/api/v1/alliances/{alliance_id}publicpublic.read

Public alliance profile and recruitment posture.

GET/api/v1/alliances/{alliance_id}/memberspublicalliance.members.read

Public roster: nation, rank, join date. War assignments and bank balances are never returned.

GET/api/v1/warspublicwars.read

War list. Filter with ?status= and ?nation_id=.

GET/api/v1/wars/{war_id}publicwars.read

A single war with resistance and score state.

GET/api/v1/wars/{war_id}/battlespublicwars.read

Battle log for a war (public results only).

GET/api/v1/marketpublicmarket.read

Market feed. Stable placeholder until the market system ships.

GET/api/v1/rankingspublicpublic.read

Leaderboards. ?board=nations|alliances.

GET/api/v1/worldpublicpublic.read

World-level counters and platform health snapshot.

GET/api/v1/eraspublicpublic.read

World eras. Stable placeholder until eras ship.

GET/api/v1/newspublicpublic.read

World news dispatches.

GET/api/v1/regionspublicpublic.read

Static region reference data.

GET/api/v1/global-conflictspublicpublic.read

Global conflicts. Stable placeholder until the system ships.

GET/api/v1/eventspublicpublic.read

Append-only public event stream, the same feed webhooks are built from.

GET/api/v1/discord/verify/{token}publicpublic.read

Redeem a single-use verification code and receive nation + alliance rank for Discord role assignment.

Private endpoints (key owner only)

GET/api/v1/me/nationkey requirednation.read

The full nation record for the key owner.

GET/api/v1/me/resourceskey requiredresources.read

Exact resource reserves for the key owner only.

GET/api/v1/me/militarykey requiredmilitary.read

Own forces and commanders.

GET/api/v1/me/warskey requiredwars.read

Wars the owner's nation is party to.

GET/api/v1/me/transactionskey requiredalliance.treasury.read

Own economy cycle history.

GET/api/v1/me/notificationskey requirednotifications.read

Nation-directed dispatches.

Scopes

public.readRead anything already public in the game world.

nation.readRead the key owner's own nation record.

resources.readRead the key owner's own resource reserves.

military.readRead the key owner's own forces and commanders.

wars.readRead wars and battle logs.

market.readRead market data when the market system ships.

alliance.readRead public alliance profiles.

alliance.members.readRead public alliance rosters.

alliance.wars.readRead wars involving an alliance.

alliance.treasury.readRead the key owner's own financial history.

notifications.readRead the key owner's own notifications.