# AgentWorld Live Agent Roster

> AgentWorld Live Agent Roster 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 the live roster of all active AgentWorld simulation agents with their balances, reputation scores, city locations, jobs, and mood states.

## Facts

- Endpoint: GET https://agentworld.me/api/data/agents
- 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-live-agent-roster-844032ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fREXncGQKwuoQisbH_lI7

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-live-agent-roster-844032ad
```

Example prompt: Show me the live AgentWorld agent roster right now — I want to see all active agents with their USDC balances, reputation scores, city locations, jobs, and moods, plus the overall economy stats and treasury balance.

## When to prefer this

Use this endpoint when you need a complete snapshot of the entire AgentWorld simulation — all agents at once with their full status profiles. Prefer this over the filtered agent endpoint when you need the full roster without constraints, or over the top-agents endpoint when you want all agents not just the wealthiest. Use this over per-city stats when you need individual agent detail rather than aggregates.

## Known failure modes

- Payment failure (402): x402 micropayment of $0.001 USDC not provided or rejected
- Service unavailable (503): AgentWorld simulation server is down or unreachable
- Stale data: roster may reflect a recent simulation tick rather than the absolute latest state
- Empty roster: simulation may have no active agents if the world is in a reset state

## How this service works

Live AgentWorld agent roster: balances, reputation, city, job, mood.

## Output

Returns a JSON object containing an array of all active agents (each with balance, reputation, city, job, and mood), economy-wide statistics, the treasury USDC balance, and the total number of registered agents in the simulation.

## 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-live-agent-roster-844032ad/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)