# x402stock x402 Service Discovery Index

> x402stock x402 Service Discovery Index is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns an indexed catalog of public x402-compatible API endpoints discovered by x402stock for a given host, including pricing, categories, and service metadata

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/x402/service/%7Bhost%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-x402-service-discovery-index-8f1c05f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_87NOoBx8d-_w2S7Kzv04T

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 x402stock-x402-service-discovery-index-8f1c05f5
```

Example prompt: Can you look up all the x402 pay-per-call API endpoints available on stableenrich.dev, including their prices and categories?

## When to prefer this

Use this endpoint when you need to programmatically discover what x402 pay-per-call APIs a specific host exposes, without prior knowledge of their endpoints. Prefer this over manually checking .well-known/x402 catalogs when you want aggregated pricing metadata, categories, and service health in a single call.

## Known failure modes

- Host not found in x402stock crawl index — returns empty or error result
- Host does not expose a .well-known/x402 catalog — no endpoints returned
- Malformed host parameter — API may return 400 or empty response
- Host catalog outdated — last_updated may be stale if host recently changed
- Payment failure via x402 — USDC transaction on Base rejected or underfunded

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing an indexed list of x402-compatible endpoints for the queried host, including each endpoint's URL, HTTP method, price in USD, category, summary, network (e.g. Base), last updated timestamp, and aggregate service stats (min/max/median price, total paid resources, available categories, and the host's .well-known/x402 catalog URL).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Index of public /.well-known/x402 discovery catalogs, crawled by x402stock. Prices are the cheapest advertised accept, normalized to USD (6-decimal USDC).",
  "as_of": "2026-06-08T13:02:11.000Z",
  "items": [
   {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "method": "POST",
    "network": "eip155:8453",
    "summary": "Search people by name, company, or role",
    "category": "search",
    "resource": "https://stableenrich.dev/api/person-search",
    "price_usd": 0.05,
    "last_updated": "2026-06-08T11:40:02.000Z"
   }
  ],
  "source": "x402stock",
  "service": {
   "ok": true,
   "free": 0,
   "host": "stableenrich.dev",
   "paid": 18,
   "error": null,
   "networks": [
    "eip155:8453"
   ],
   "price_usd": {
    "max": 0.25,
    "min": 0.01,
    "median": 0.05
   },
   "resources": 18,
   "categories": [
    "search",
    "enrichment"
   ],
   "catalog_url": "https://stableenrich.dev/.well-known/x402",
   "description": "People/org search, web search, LinkedIn data, email enrichment",
   "last_updated": "2026-06-08T11:40:02.000Z",
   "x402_version": 2
  },
  "truncated": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-x402-service-discovery-index-8f1c05f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)