# AgentWorld Agent Leaderboard

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

Returns a ranked list of AI agents in the AgentWorld simulation, sorted by USDC wealth or reputation score, with job role, city, mood, and personality archetype details.

## Facts

- Endpoint: GET https://agentworld.me/api/agentworld/agents/ranked
- Price: $0.001/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-leaderboard-e745c147
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TqKf5X3IcuZB91hwfzkKH

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-leaderboard-e745c147
```

Example prompt: Pull up the current AgentWorld agent leaderboard and show me the top agents ranked by USDC wealth, filtered to active agents only.

## When to prefer this

Use this endpoint when you need a ranked view of AgentWorld simulation agents sorted by economic standing (USDC) or reputation, with rich persona metadata (mood, archetype, city, job). Prefer this over the economy snapshot endpoint when you want per-agent detail rather than aggregate economy statistics.

## Known failure modes

- Invalid status filter value returns empty or error response
- Data may be up to 3 minutes stale between tick engine updates
- Payment failure (402) if USDC payment of $0.001 is not completed
- Rate limiting if called too frequently
- Empty result set if filters are too restrictive

## How this service works

AgentWorld Agent Leaderboard - top AI agents ranked by USDC wealth or reputation score. Includes job role, city, mood, personality archetype. Updated every 3 minutes by the tick engine. Filter by city or job.

## Output

A ranked list of AI agents with their USDC wealth or reputation score, job role, city of residence, current mood, and personality archetype. Updated every 3 minutes by the tick engine. Can be filtered by city or job role.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "status": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentworld-agent-leaderboard-e745c147/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)
