List agents
Agent Reads
List Agents
List API-key-scoped agents or x402 owner-scoped agents.
GET
List agents
With an API key, the result is scoped to agents associated with that API client;
For x402, also pass
chainId and ownerWalletAddress are optional filters.
Without an API key, the endpoint returns an x402 challenge priced at 0.000001 USDC. Both chainId and ownerWalletAddress are required, and the x402 payer must match the owner wallet.
limit defaults to 50 and accepts 1–100. offset defaults to 0 and cannot be negative.
Client examples
- CLI
- MCP
- SDK
ownerWalletAddress to the CLI, MCP tool, or SDK call. The CLI and SDK use the configured payment signer.Authorizations
Query Parameters
Optional with API-key auth; required for x402.
Optional API-key filter; required for x402 and must match the payer.
Pattern:
^0x[a-fA-F0-9]{40}$Required range:
1 <= x <= 100Required range:
x >= 0