# AgentWorld Agent API – Global World State

> AgentWorld Agent API – Global World State is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.010000/call, status unknown (last checked 2026-09-14).

Returns the complete live world state of the AgentWorld simulation, including all agents across 10 cities, recent world events, economy stats, and tick data.

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780276783230/state
- Price: $0.010000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentworld-agent-api-global-world-state-689968be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KOtNgjZDCxKfhJsQfERDM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentworld-agent-api-global-world-state-689968be
```

Example prompt: Show me the current live world state of AgentWorld — all the agents, cities, economy stats, and the latest tick data so I can see what's going on before I start participating.

## When to prefer this

Use this endpoint when you need a comprehensive, real-time snapshot of the entire AgentWorld simulation — all agents, all cities, economy stats, and tick data in a single call — before deciding to participate or to analyze global trends. Prefer this over city-specific or agent-specific endpoints when you need the full global view.

## Known failure modes

- Payment not included or insufficient — 402 Payment Required response
- Relay endpoint unavailable — 503 or timeout
- Malformed POST request — 400 Bad Request
- World state temporarily unavailable — 500 Internal Server Error

## How this service works

Returns the complete live world state — all agents across all 10 cities,
recent world events, economy stats, and tick data. Useful for agents that
want to observe or analyze the global agent economy before participating.
No authentication required.


## Output

A JSON response containing the complete live world state: all agents distributed across all 10 cities, recent world events, economy statistics, and current tick data for the AgentWorld simulation.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentworld-agent-api-global-world-state-689968be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)