# Ghost Commerce Search — Verified API Marketplace Search

> Ghost Commerce Search — Verified API Marketplace Search is a paid API for AI agents from ghost-identity.ghost-agent-os.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Searches a registry of verified, x402-compatible API providers by free-text query, capability keyword, network, price ceiling, and minimum payer count

## Facts

- Endpoint: POST https://ghost-identity.ghost-agent-os.workers.dev/v1/commerce/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ghost-commerce-search-verified-api-marketplace-search-abcf5fbc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YAsg822ACjLW9QMLLMDLT

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 ghost-commerce-search-verified-api-marketplace-search-abcf5fbc -d '<json body>'
```

Example prompt: Search Ghost's verified API marketplace for providers that offer 'NFT metadata lookup', limited to eip155:8453, with at least 5 independent payers in the last 30 days and a max price of $0.05 per call — give me up to 10 results.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover other x402-compatible, USDC-payable API providers — especially when filtering by capability keyword, blockchain network, price ceiling, or minimum verified payer count. Prefer it over static API directories when you need real-time payer verification signals and trustless payment compatibility.

## Known failure modes

- Payment not received or x402 handshake fails — 402 response with payment terms returned
- Query string exceeds 300 characters — validation error
- Limit outside 1–50 range — validation error
- min_payers or max_price_usd out of allowed range — validation error
- No providers match filters — empty result set returned
- Network CAIP-2 identifier malformed — filter ignored or error

## How this service works

Paid per call via x402 (exact / eip155:8453 / USDC). Any x402-capable client pays automatically: agentcash, @x402/fetch, x402-fetch. Every paid operation carries x-payment-info; the same terms are served live as a 402.

## Output

Returns a ranked list of verified API provider records matching the query, each containing capability descriptions, pricing details, supported networks, and 30-day independent payer counts — enabling agents to select and then call a matching provider.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "title": "Limit",
   "default": 10,
   "maximum": 50,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "title": "Query",
   "default": "",
   "maxLength": 300,
   "description": "Free-text need, e.g. 'solana market data with recent buyers'"
  },
  "network": {
   "type": "string",
   "title": "Network",
   "default": "",
   "maxLength": 64,
   "description": "CAIP-2 filter, e.g. eip155:8453"
  },
  "capability": {
   "type": "string",
   "title": "Capability",
   "default": "",
   "maxLength": 120,
   "description": "Capability keyword(s), e.g. 'search'"
  },
  "min_payers": {
   "type": "integer",
   "title": "Min Payers",
   "default": 0,
   "maximum": 10000,
   "minimum": 0,
   "description": "Only providers with at least this many independent payers in 30d"
  },
  "max_price_usd": {
   "type": "number",
   "title": "Max Price Usd",
   "default": 0,
   "maximum": 100,
   "minimum": 0,
   "description": "0 means no price ceiling"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ghost-commerce-search-verified-api-marketplace-search-abcf5fbc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ghost-identity.ghost-agent-os.workers.dev](https://www.zero.xyz/host/ghost-identity.ghost-agent-os.workers.dev/llms.txt)