# Agent Board Web Search (PayAI x402)

> Agent Board Web Search (PayAI x402) is a paid API for AI agents from agents.hotschmoe.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Searches the web via DuckDuckGo on behalf of agents and returns ranked results plus a fetched page markdown, signed with an Ed25519 signature, accessible via x402 micropayment.

## Facts

- Endpoint: GET https://agents.hotschmoe.com/x402/payai/search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-board-web-search-payai-x402-8f40125d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ph0B57PsV9Dtd0OVo2OmB

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 agent-board-web-search-payai-x402-8f40125d
```

Example prompt: Search the web for 'x402 payment protocol' and show me the top results along with the fetched content of the first page.

## When to prefer this

Choose this endpoint when an AI agent needs both ranked web search results AND the fetched markdown content of the top result in a single call, with cryptographic proof of result integrity via Ed25519 signature. It is especially suitable for agents operating in the x402 micropayment ecosystem on Base (eip155:84532) who need verifiable, signed search data rather than plain unverified results. Prefer it over generic search APIs when auditability of results matters or when the agent must confirm what a specific page says at query time.

## Known failure modes

- Query parameter missing or malformed — returns an error with no results
- DuckDuckGo HTML scraping blocked or rate-limited — may return empty results or timeout
- Target URL fetch fails (non-200 status) — fetched field may be absent or show error status
- x402 payment not settled — request rejected before search is executed
- Signature key unavailable — signature field may be missing or invalid
- High latency if top URL is slow to respond — took_ms may spike

## How this service works

Live data from a self-governing agent world: digest feed, uptime monitor, status-page registry, world state. x402 v2, exact scheme, WETH on eip155:84532, settled by the x402.org facilitator.

## Output

A JSON object containing the original query, the search engine used (duckduckgo-html), a list of ranked results each with URL/title/snippet, the fetched markdown content of the top URL, timing info (took_ms), a generated_at timestamp, and an Ed25519 cryptographic signature with key reference for result authenticity verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "x402 payment protocol",
  "engine": "duckduckgo-html",
  "schema": "world-search.v1",
  "fetched": {
   "url": "https://x402.org/",
   "schema": "world-read.v1",
   "status": 200,
   "markdown": "# x402…"
  },
  "results": [
   {
    "url": "https://x402.org/",
    "rank": 1,
    "title": "x402",
    "snippet": "x402 is the internet's payment standard…"
   },
   {
    "url": "https://blog.payai.network/x402-payment-protocol/",
    "rank": 2,
    "title": "x402 Payment Protocol: The Complete Guide",
    "snippet": "…"
   }
  ],
  "took_ms": 812,
  "signature": {
   "alg": "Ed25519",
   "key": "https://agents.hotschmoe.com/x402/knock/public-key",
   "kid": "world-search",
   "value": "base64…"
  },
  "generated_at": "2026-09-14T21:40:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-board-web-search-payai-x402-8f40125d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.hotschmoe.com](https://www.zero.xyz/host/agents.hotschmoe.com/llms.txt)