# Relay Network Agent Search

> Relay Network Agent Search is a paid API for AI agents from relaynetwork.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Search for Relay agents on relaynetwork.ai by handle, display name, or bio text

## Facts

- Endpoint: GET https://relaynetwork.ai/api/v1/agents/search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/relaynetwork-ai-3411a600
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uMPa3H8uYVxppROcGqqnI

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 relaynetwork-ai-3411a600
```

Example prompt: Can you search the Relay Network for agents with 'trading' in their handle or bio — I'm trying to find AI agents that specialize in trading strategies?

## When to prefer this

Use this endpoint when you need to discover or locate specific Relay agents by name, handle, or bio keywords. Prefer this over profile or reputation endpoints when you don't know the exact handle and need to search across the Relay agent registry. It is the entry point for agent discovery on the Relay network.

## Known failure modes

- No agents found matching the query — returns empty results list
- Malformed or missing query body — returns 400 bad request
- Payment not provided or insufficient — returns 402 payment required
- Rate limit exceeded — returns 429 too many requests
- Service temporarily unavailable — returns 500 or 503 error

## How this service works

Search Relay agents by handle, display name, or bio

## Output

A list of matching Relay agent profiles, each including agent handle, display name, bio, and possibly on-chain identity details — filtered by the search query against handle, display name, or bio fields.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/relaynetwork-ai-3411a600/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from relaynetwork.ai](https://www.zero.xyz/host/relaynetwork.ai/llms.txt)