Skip to main content
GET
List agents
With an API key, the result is scoped to agents associated with that API client; 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 1100. offset defaults to 0 and cannot be negative.

Client examples

For x402, also pass ownerWalletAddress to the CLI, MCP tool, or SDK call. The CLI and SDK use the configured payment signer.

Authorizations

x-api-key
string
header
required

Query Parameters

chainId
string

Optional with API-key auth; required for x402.

ownerWalletAddress
string

Optional API-key filter; required for x402 and must match the payer.

Pattern: ^0x[a-fA-F0-9]{40}$
limit
integer
default:50
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0

Response

Paginated agent list.

agents
object[]
required
total
integer
required
limit
integer
required
offset
integer
required