# x402stock Economy Discovery Index

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

Returns an index of all x402-compatible pay-per-call market and economic data services crawled from public discovery catalogs, including pricing stats and resource counts.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/x402/economy
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-economy-discovery-index-93ad97e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Hqhg7gNpxmvDyq4tUYUCg

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-economy-discovery-index-93ad97e2
```

Example prompt: Give me a live snapshot of all the pay-per-call financial data services indexed by x402stock — I want to see how many paid resources are available, their price range, and how they break down by category and network.

## When to prefer this

Use this endpoint when an AI agent needs to discover what x402-protocol financial and economic data APIs exist, compare pricing across services, or build a meta-view of the pay-per-call data ecosystem before deciding which specific endpoint to call. Prefer this over individual endpoints when the goal is service discovery rather than fetching specific market data.

## Known failure modes

- Invalid or unrecognized 'properties' filter returns empty or default index
- Service temporarily unavailable returns HTTP 5xx
- Payment not completed or malformed x402 header returns 402 Payment Required
- Stale index if upstream discovery catalogs are slow to update

## 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 listing all x402-compatible services crawled from public discovery catalogs, with per-host resource and pricing details, overall price distribution (min, max, p25, median, p75), total resource count, breakdown by blockchain network and data category (financial-data, search, enrichment, media), and the timestamp of the index.

## Example request

```json
{
 "properties": "all"
}
```

## 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",
  "source": "x402stock",
  "services": [
   {
    "ok": true,
    "free": 3,
    "host": "x402stock.xyz",
    "paid": 124,
    "resources": 127,
    "median_price_usd": 0.03
   },
   {
    "ok": true,
    "free": 0,
    "host": "stableenrich.dev",
    "paid": 18,
    "resources": 18,
    "median_price_usd": 0.05
   }
  ],
  "price_usd": {
   "max": 1.5,
   "min": 0.001,
   "p25": 0.01,
   "p75": 0.08,
   "median": 0.03
  },
  "resources": 214,
  "by_network": {
   "eip155:8453": 201,
   "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": 13
  },
  "by_category": {
   "media": 22,
   "search": 31,
   "enrichment": 24,
   "financial-data": 127
  },
  "services_up": 8,
  "free_resources": 7,
  "paid_resources": 207,
  "services_indexed": 9
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-economy-discovery-index-93ad97e2/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)