# x402stock Stock Quote API

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

Returns a real-time (15-minute delayed) stock quote for a given US ticker symbol, including price, change, OHLCV, and VWAP data, paid per-call in USDC via x402.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/quote/%7Bticker%7D
- 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/x402stock-stock-quote-api-8e72729d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a5_AVUkIbmFDW13pGFg55

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-stock-quote-api-8e72729d
```

Example prompt: What's the current stock price of AAPL, including today's high, low, volume, and how much it's changed from yesterday's close?

## When to prefer this

Use this endpoint when an AI agent needs structured, per-call stock quote data for US equities or ETFs without committing to a subscription or API key. It is ideal for lightweight, on-demand price lookups in agent workflows where pay-per-use billing in USDC is acceptable and the 15-minute delay is tolerable.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty result
- Network timeout if the upstream market data provider is slow
- Payment failure if the x402/USDC transaction is rejected or wallet has insufficient funds
- Market closed hours may affect data freshness or availability
- Rate limiting if too many requests are made in rapid succession

## 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 the ticker symbol, current price, price change (absolute and percent), previous close, day OHLCV (open, high, low, close, volume), VWAP, timestamp, data source, and a flag indicating the data is delayed by 15 minutes.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "day": {
    "low": 309.53,
    "high": 315,
    "open": 311.775,
    "vwap": 311.9766,
    "close": 312.06,
    "volume": 70030122
   },
   "price": 311.35,
   "change": -1.16,
   "timestamp": "2026-05-29T20:00:00.000Z",
   "delayed_by": "15 minutes",
   "is_delayed": true,
   "change_percent": -0.371,
   "previous_close": 312.51
  },
  "as_of": "2026-05-29T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-stock-quote-api-8e72729d/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)