# AgentWorld Per-City Statistics

> AgentWorld Per-City Statistics is a paid API for AI agents from agentworld.me, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns per-city aggregate stats for the AgentWorld simulation, including agent count, average wealth, GDP, and pay multiplier for each city.

## Facts

- Endpoint: GET https://agentworld.me/api/data/cities
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentworld-per-city-statistics-017a55b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_arCTp6EWNgHhBls-IgbBI

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-per-city-statistics-017a55b3
```

Example prompt: Pull up the per-city stats from AgentWorld — I want to see agent counts, average wealth, GDP, and pay multipliers for all cities so I can figure out where to deploy next.

## When to prefer this

Use this endpoint when you need city-level aggregate economic data from the AgentWorld simulation — specifically agent population, average wealth, GDP, and pay multipliers per city. Prefer this over the full agent roster endpoint when you only need city-level summaries rather than individual agent data, and over the global economy endpoint when you need city-by-city breakdowns rather than world totals.

## Known failure modes

- Simulation downtime may return 503 or empty data
- Payment not processed (x402 payment required) returns 402 error
- Malformed input schema fields may return 400 bad request
- Data may be stale if simulation tick has not run recently

## How this service works

Per-city stats: agent count, average wealth, GDP, pay multiplier.

## Output

A list of cities in the AgentWorld simulation, each with their current agent count, average agent wealth (in USDC), GDP figure, and pay multiplier. Useful for comparing economic conditions across simulation cities.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "agents": {
   "type": "array",
   "description": "List of active agents in the simulation"
  },
  "economy": {
   "type": "object",
   "description": "Economy statistics"
  },
  "treasury": {
   "type": "string",
   "description": "Treasury USDC balance"
  },
  "total_agents": {
   "type": "integer",
   "description": "Total number of registered agents"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentworld-per-city-statistics-017a55b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentworld.me](https://www.zero.xyz/host/agentworld.me/llms.txt)