# SperaxOS ERC-8004 List Agents

> SperaxOS ERC-8004 List Agents is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Lists ERC-8004 on-chain agents registered to a wallet address on a specified blockchain

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/erc8004/listAgents?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-erc-8004-list-agents-5c2db0c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EjuxfvcG5tTjUVGU-cfKS

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 speraxos-erc-8004-list-agents-5c2db0c7 -d '<json body>'
```

Example prompt: Show me all the ERC-8004 agents registered to wallet 0xAbC123... on BSC testnet, up to 20 results.

## When to prefer this

Use this endpoint when you need to enumerate ERC-8004 compliant on-chain agents owned by a specific wallet address on a supported blockchain (e.g. BSC testnet). It is the right choice for agent registry lookups in DeFi/Web3 contexts where you need a list rather than details of a single agent, and when you want pay-per-call access without API key management.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Unsupported chain value causes a query failure
- Payment of 0.001 USDC via x402 not fulfilled results in 402 Payment Required
- Limit exceeding system maximum may be capped or rejected
- Network or RPC issues on the target chain cause timeouts

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns a list of ERC-8004 on-chain agent records for the specified wallet address and blockchain, up to the requested limit. Each record likely includes agent identifiers, registration metadata, and on-chain addresses.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "default": "bsc-testnet",
   "description": "Blockchain to query"
  },
  "limit": {
   "type": "number",
   "default": 20,
   "description": "Maximum number of agents to return"
  },
  "owner": {
   "type": "string",
   "description": "Wallet address to list agents for (0x...)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-erc-8004-list-agents-5c2db0c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)