# Massive x402 API – US Stocks Snapshot by Direction

> Massive x402 API – US Stocks Snapshot by Direction 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-15).

Returns a real-time snapshot of US stock market tickers filtered by direction (gainers or losers), purchased per-request via x402 micropayment with no API key or subscription required.

## Facts

- Endpoint: GET https://agent.massive.com/v2/snapshot/locale/us/markets/stocks/%7Bdirection%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/massive-x402-api-us-stocks-snapshot-by-direction-ff3e33de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ABdA4pJtY8ijaxoPnRJ_b

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-stocks-snapshot-by-direction-ff3e33de
```

Example prompt: What are the top gaining US stocks right now? Pull me the latest snapshot of today's biggest movers — I want to see price, volume, and how much they've changed.

## When to prefer this

Choose this endpoint when you need live US stock market snapshot data (gainers or losers) without committing to a subscription or managing API keys — ideal for pay-per-use agent workflows, one-off queries, or low-frequency polling where a $0.01/call micropayment model is more cost-effective than a monthly plan. Prefer it when your agent already supports the x402 payment protocol and you need structured OHLCV, quote, trade, and change data in a single call.

## Known failure modes

- 402 Payment Required — returned when no valid x402 payment header is supplied; response includes payment terms in PAYMENT-REQUIRED header
- Invalid direction parameter — unsupported path segment returns error or empty result
- Payment settlement failure — if USDC payment does not settle, data is not returned
- Rate or network timeout — real-time data endpoint may time out under high load
- Empty tickers array — returned if no stocks match the direction filter at the requested moment

## 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 with status 'OK' and an array of ticker snapshots, each containing: intraday OHLCV bar (open, high, low, close, volume, dollar volume, VWAP), latest minute bar with timestamp, previous day OHLC and VWAP, last quote (bid/ask prices and sizes), last trade (price, size, exchange, conditions), today's absolute change, and today's percentage change.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "OK",
  "tickers": [
   {
    "day": {
     "c": 14.2284,
     "h": 15.09,
     "l": 14.2,
     "o": 14.33,
     "v": 133963,
     "dv": "133963.0",
     "vw": 14.5311
    },
    "min": {
     "c": 14.2284,
     "h": 14.325,
     "l": 14.2,
     "n": 5,
     "o": 14.28,
     "t": 1684428600000,
     "v": 6108,
     "av": 133963,
     "dv": "6108.0",
     "vw": 14.2426,
     "dav": "133963.0"
    },
    "ticker": "PDS",
    "prevDay": {
     "c": 0.73,
     "h": 0.799,
     "l": 0.73,
     "o": 0.75,
     "v": 1568097,
     "vw": 0.7721
    },
    "updated": 1605195848258266000,
    "lastQuote": {
     "P": 14.44,
     "S": 11,
     "p": 14.2,
     "s": 25,
     "t": 1605195929997325600
    },
    "lastTrade": {
     "c": [
      63
     ],
     "i": "79372124707124",
     "p": 14.2284,
     "s": 536,
     "t": 1605195848258266000,
     "x": 4,
     "ds": "536.0"
    },
    "todaysChange": 13.498,
    "todaysChangePerc": 1849.096
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/massive-x402-api-us-stocks-snapshot-by-direction-ff3e33de/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)