# Massive x402 API – US Stock Snapshot (Single Ticker)

> Massive x402 API – US Stock Snapshot (Single Ticker) is a paid API for AI agents from agent.massive.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns real-time snapshot data for a single US stock ticker including current price, OHLC, volume, last trade, and last quote, paid per-request via x402 micropayment.

## Facts

- Endpoint: GET https://agent.massive.com/v2/snapshot/locale/us/markets/stocks/tickers/%7BstocksTicker%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/massive-x402-api-us-stock-snapshot-single-ticker-1422b44d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JoDbmL84b4FY5i132BDKf

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 massive-x402-api-us-stock-snapshot-single-ticker-1422b44d
```

Example prompt: What's the current price snapshot for AAPL — give me the last trade, today's OHLC, volume, and percentage change?

## When to prefer this

Choose this endpoint when you need real-time or near-real-time US stock market snapshot data for a single ticker without requiring an account, API key, or subscription. It is ideal for pay-per-use agent workflows where cost should scale with usage, or for one-off lookups. Prefer this over subscription-based stock APIs when you only need occasional data points or want to avoid monthly fees. Not suited for bulk historical data, options data, or non-US markets.

## Known failure modes

- 402 Payment Required returned if x402 payment header is missing or payment has not settled
- Invalid or unsupported ticker symbol returns error or empty ticker object
- Market closed hours may result in stale or missing minute-bar data
- Network timeout if payment settlement takes too long
- Malformed ticker path parameter causes 404 or bad request error

## How this service works

US stock market data, sold per request over x402. Every path here answers 402 with the payment terms in the PAYMENT-REQUIRED header, and answers with the data once the payment settles. No account, no API key, no subscription.

## Output

A JSON object containing the ticker symbol, day-level OHLC and volume, minute-bar data, previous day OHLC, last quote (bid/ask price and size), last trade (price, size, exchange, timestamp), today's change in dollars and percent, and a request ID. Data reflects near-real-time US equity market conditions.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "OK",
  "ticker": {
   "day": {
    "c": 120.4229,
    "h": 120.53,
    "l": 118.81,
    "o": 119.62,
    "v": 28727868,
    "dv": "28727868.0",
    "vw": 119.725
   },
   "min": {
    "c": 120.4201,
    "h": 120.468,
    "l": 120.37,
    "n": 762,
    "o": 120.435,
    "t": 1684428720000,
    "v": 270796,
    "av": 28724441,
    "dv": "270796.0",
    "vw": 120.4129,
    "dav": "28724441.0"
   },
   "ticker": "AAPL",
   "prevDay": {
    "c": 119.49,
    "h": 119.63,
    "l": 116.44,
    "o": 117.19,
    "v": 110597265,
    "vw": 118.4998
   },
   "updated": 1605195918306274000,
   "lastQuote": {
    "P": 120.47,
    "S": 4,
    "p": 120.46,
    "s": 8,
    "t": 1605195918507251700
   },
   "lastTrade": {
    "c": [
     14,
     41
    ],
    "i": "4046",
    "p": 120.47,
    "s": 236,
    "t": 1605195918306274000,
    "x": 10,
    "ds": "236.0"
   },
   "todaysChange": 0.98,
   "todaysChangePerc": 0.82
  },
  "request_id": "657e430f1ae768891f018e08e03598d8"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/massive-x402-api-us-stock-snapshot-single-ticker-1422b44d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.massive.com](https://www.zero.xyz/host/agent.massive.com/llms.txt)