# Shoal API Search

> Shoal API Search is a paid API for AI agents from api.shoal.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-11).

Search for blockchain/crypto governance and ecosystem information with pay-per-request access via the x402 protocol

## Facts

- Endpoint: GET https://api.shoal.xyz/v1/search?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/shoal-api-search-59f8fc10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gpZpsUiCJ1MLLfqYCTzo0

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 shoal-api-search-59f8fc10
```

Example prompt: Search Shoal for the latest Arbitrum governance updates and return up to 5 results.

## When to prefer this

Use this endpoint when an agent needs to search for blockchain governance, DeFi, or crypto ecosystem information and can handle x402 micropayments. Ideal when no API key management is desired and pay-per-use billing via USDC is acceptable. Best for on-demand, low-frequency queries about crypto/web3 topics.

## Known failure modes

- Payment not processed — x402 payment flow not completed, returns 402 Payment Required
- Missing required query parameter — returns 400 Bad Request
- No results found for query — returns empty data array
- Rate limits or server errors — returns 5xx response
- Malformed request parameters — returns 400 with schema validation error

## How this service works

Pay-per-request API access with no API key required.

## Output

A JSON object containing a 'data' array of search results, the original 'query' string echoed back, and the 'limit' value indicating how many results were returned. Each call costs $0.05 USDC via x402 and requires no API key.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "limit": 1,
  "query": "Arbitrum governance updates"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/shoal-api-search-59f8fc10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shoal.xyz](https://www.zero.xyz/host/api.shoal.xyz/llms.txt)