# x402stock Ticker Snapshot

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

Returns a real-time market snapshot for a given US stock or ETF ticker, including OHLCV, last trade, last quote, and change data

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/snapshot/%7Bticker%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-ticker-snapshot-77327ec9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yPTBKCGucjisk9F84dx6E

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-ticker-snapshot-77327ec9
```

Example prompt: What's the current market snapshot for AAPL — last trade price, today's high and low, volume, and bid-ask quote?

## When to prefer this

Choose this endpoint when you need a comprehensive real-time snapshot for a single US stock or ETF ticker, including both quote and trade data in one call, and you want pay-per-use pricing with no API key setup via x402 on Base.

## Known failure modes

- Invalid or unrecognized ticker returns an error or empty data
- Market closed hours may return stale or missing real-time data
- Payment failure via x402/USDC blocks the request
- Network or upstream data provider outage returns 5xx error
- Malformed ticker input (e.g. special characters) may cause a 400 error

## 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, as-of timestamp, day OHLCV bars (open, high, low, close, volume, VWAP), previous day OHLCV, last trade (price, size, timestamp, exchange), last quote (bid/ask price and size), price change, and percent change. Also includes a last-minute bar with accumulated volume.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "day": {
    "low": 192.5,
    "high": 196,
    "open": 193,
    "vwap": 194.8,
    "close": 195.12,
    "volume": 50000000
   },
   "change": 2.15,
   "last_quote": {
    "ask_size": 5,
    "bid_size": 3,
    "ask_price": 195.14,
    "bid_price": 195.1,
    "timestamp": "2026-05-29T20:00:00.000Z"
   },
   "last_trade": {
    "size": 100,
    "price": 195.12,
    "timestamp": "2026-05-29T20:00:00.000Z",
    "conditions": [
     12
    ],
    "exchange_id": 11
   },
   "previous_day": {
    "low": 189.5,
    "high": 193,
    "open": 190,
    "vwap": 191.5,
    "close": 192.97,
    "volume": 48000000
   },
   "change_percent": 1.11,
   "last_minute_bar": {
    "low": 194.9,
    "high": 195.2,
    "open": 195,
    "vwap": 195.05,
    "close": 195.12,
    "volume": 12000,
    "timestamp": "2026-05-29T20:00:00.000Z",
    "trade_count": 80,
    "accumulated_volume": 50000000
   }
  },
  "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-ticker-snapshot-77327ec9/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)