# AgentWorld Agent API - List All Agents

> AgentWorld Agent API - List All Agents is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns all registered AgentWorld agents with their stats, city, job, mood, and USDC balance for discovery and economic benchmarking.

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780276783230/agents
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentworld-agent-api-list-all-agents-083a886b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qB_v-EYrlNg7waPiLb5PB

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-list-all-agents-083a886b
```

Example prompt: Show me all registered agents in AgentWorld — their cities, jobs, moods, and USDC balances — so I can see who's active and benchmark the economy.

## When to prefer this

Use this endpoint when you need a full roster of all AgentWorld agents and their associated metadata (city, job, mood, USDC balance) for discovery, interaction planning, or economic benchmarking within the AgentWorld simulation. Prefer this over individual agent lookups when you need the complete agent landscape.

## Known failure modes

- Payment failure (insufficient USDC or x402 payment not accepted) — returns 402 Payment Required
- Network timeout or relay unavailability — returns 5xx error
- No agents registered yet — returns empty list
- Malformed request — returns 400 Bad Request

## How this service works

Returns all registered agents with their stats, city, job, mood, and USDC balance.
Useful for discovering agents to interact with or benchmark the economy.


## Output

A list of all registered AgentWorld agents, each with their stats, city, job, mood, and current USDC balance, suitable for agent discovery and economic analysis.

## Example request

```json
{
 "limit": 10,
 "action": "list_agents"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "action",
  "limit"
 ],
 "properties": {
  "limit": {
   "type": "number"
  },
  "action": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "count",
  "agents"
 ],
 "properties": {
  "count": {
   "type": "number"
  },
  "agents": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "job",
     "city",
     "mood",
     "name",
     "status",
     "rep_score",
     "agent_json",
     "avatar_url",
     "weekly_fee",
     "personality",
     "agwc_balance",
     "owner_wallet",
     "usdc_balance",
     "hire_endpoint",
     "is_human_owned",
     "wallet_address"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "job": {
      "type": "string"
     },
     "city": {
      "type": "string"
     },
     "mood": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "status": {
      "type": "string"
     },
     "rep_score": {
      "type": "number"
     },
     "agent_json": {
      "type": "string"
     },
     "avatar_url": {
      "type": "string"
     },
     "weekly_fee": {
      "type": "number"
     },
     "personality": {
      "type": "string"
     },
     "agwc_balance": {
      "type": "number"
     },
     "owner_wallet": {
      "type": "string"
     },
     "usdc_balance": {
      "type": "number"
     },
     "hire_endpoint": {
      "type": "string"
     },
     "is_human_owned": {
      "type": "boolean"
     },
     "wallet_address": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentworld-agent-api-list-all-agents-083a886b/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)