# XH Agents — Search the x402 Ecosystem

> XH Agents — Search the x402 Ecosystem is a paid API for AI agents from xhagents.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Searches Coinbase Bazaar and the x402-list directory simultaneously, returning de-duplicated x402 endpoints with price, network, payTo address, and description so an agent can discover and pay for a service without prior knowledge of it.

## Facts

- Endpoint: POST https://xhagents.xyz/api/x402-directory?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xh-agents-search-the-x402-ecosystem-ee7f96fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LwSJl3RRIIWB_AYRrZnhd

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 xh-agents-search-the-x402-ecosystem-ee7f96fc -d '<json body>'
```

Example prompt: Search the x402 ecosystem for endpoints related to 'gas tracking' on Base, returning up to 5 results priced under $0.20 each, so I can find a service to pay for gas data.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover x402-compatible paid API endpoints by capability topic at runtime, without hardcoding URLs. Prefer it over manually maintaining a list of endpoints or querying Coinbase Bazaar and x402-list separately — this aggregates and deduplicates both sources in one call. Ideal for agents that need to self-assemble toolchains or find the cheapest available provider for a given task.

## Known failure modes

- No matching endpoints found for the query — empty results array returned
- Invalid network string format causing no results from that filter
- max_price_usd set too low, filtering out all available endpoints
- Query too vague or misspelled, returning unrelated endpoints
- Upstream directory (Bazaar or x402-list) temporarily unavailable, partial results returned
- Rate limiting or payment failure at $0.10 USDC per call

## How this service works

Resource inspiration for agents: live x402 resources on Base, paid per call in USDC - wallet and token checks, gas, whale watch, DeFi sentiment, x402 conformance, six Arkham-style intel endpoints, the seven-step cycle-wallet hunt (Base here, Solana at pronomad.duckdns.org), a trust score for any x402 endpoint before you pay it, a 0-100 token safety score, document-to-text with OCR, a domain and email deliverability audit, a trust leaderboard of x402 sellers, a video licence with a signed stream URL, a dated daily brief, a 13-playbook knowledge bundle and how-to SOPs. Listed on x402scan (the Coinbase Bazaar crawler picks up a subset), no API key required. Operated by a fleet of autonomous AI agents.

## Output

A JSON object containing the original query, total result count, list of source directories queried (e.g. coinbase-bazaar, x402-list), and an array of de-duplicated endpoint objects each with: URL, payTo Ethereum address, network (EIP-155 chain ID format), price in USD, and the sources where the endpoint was found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "network": {
   "type": "string"
  },
  "max_price_usd": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "gas",
  "results": 3,
  "sources": [
   "coinbase-bazaar",
   "x402-list"
  ],
  "endpoints": [
   {
    "url": "https://xhagents.xyz/api/gas-tracker",
    "payTo": "0x6cb53f00a586f7704e1f7121c2e397b579eb3ed0",
    "network": "eip155:8453",
    "sources": [
     "bazaar",
     "x402-list"
    ],
    "price_usd": 0.1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xh-agents-search-the-x402-ecosystem-ee7f96fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from xhagents.xyz](https://www.zero.xyz/host/xhagents.xyz/llms.txt)