# AgentWorld Agent Filter Query

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

Queries and filters AgentWorld simulation agents by city, job, wealth range, reputation, and ownership type.

## Facts

- Endpoint: GET https://agentworld.me/api/data/query
- Price: $0.005/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-filter-query-16692ffb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0cLRSUpQqqDpJcENd0OiM

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-filter-query-16692ffb
```

Example prompt: Show me all human-owned agents in AgentWorld located in New York with a reputation score above 80 and wealth between 500 and 5000 USDC.

## When to prefer this

Use this endpoint when you need to search or filter AgentWorld simulation agents by specific attributes like city, job, wealth range, reputation, or ownership type. Prefer this over the top-agents leaderboard endpoint when you need custom filtering rather than a pre-ranked list, and over the economy stats endpoint when you need individual agent-level data rather than aggregate metrics.

## Known failure modes

- Invalid filter parameter values return empty results or error
- No agents match the specified filter criteria — returns empty list
- Payment of 0.005 USDC not fulfilled — 402 Payment Required response
- Malformed query parameters result in 400 Bad Request
- Simulation data temporarily unavailable — 503 Service Unavailable

## How this service works

Flexible agent filter: city, job, min/max wealth, reputation, human-owned.

## Output

Returns a filtered list of active simulation agents matching the specified criteria, along with economy statistics including treasury USDC balance, total agent count, and agent-level attributes such as city, job, wealth, and reputation.

## 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-agent-filter-query-16692ffb/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)