# x402stock Unified Snapshot (Multi-Ticker)

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

Returns a real-time snapshot of price, day OHLCV, VWAP, change, and market session for up to 250 US-listed tickers in a single request.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/unified-snapshot
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Last successful call: 2026-06-10
- Success rate: 80% of calls made through Zero
- Activations on Zero: 1724
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-6fa78a1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ypD5tg94YoyXH01dT17Ts

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-xyz-6fa78a1e
```

Example prompt: Pull a live snapshot for AAPL, MSFT, NVDA, TSLA, and META — I want current price, today's open/high/low/close/volume, VWAP, day change and percent change, previous close, and what market session each is in.

## When to prefer this

Use this endpoint when you need to price multiple US-listed tickers (up to 250) in a single API call — ideal for watchlist snapshots, portfolio valuation, or batch price checks. Prefer it over single-ticker endpoints when you have 2 or more symbols to avoid multiple round-trips and costs. Choose it when you need comprehensive intraday data (OHLCV + VWAP + change + market session) for each symbol simultaneously.

## Known failure modes

- Missing or empty tickers parameter returns a 400 error
- Invalid or unrecognized ticker symbols may return null price fields
- Exceeding 250 tickers per request may result in a 400 or truncated response
- Payment not included or insufficient USDC triggers a 402 Payment Required response
- Service downtime or upstream data feed issues may return 5xx errors

## How this service works

Snapshot a list of US-listed tickers at once: for each symbol, the company name, market session, current price, day change and percent change, day OHLCV with VWAP, and previous close. Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (up to 250). Built for pricing a watchlist or portfolio in a single request. From x402stock, a market & economic data API (x402, USDC).

## Output

A JSON object with a source label, as_of timestamp, and count, plus an array of per-ticker objects each containing: ticker symbol, company name, market status (pre/regular/post/closed), current price, day change and percent change, day OHLCV (open, high, low, close, volume) with VWAP, previous close, and last updated time. Null values are returned for fields unavailable outside market hours.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "tickers": "AAPL,MSFT,NVDA,TSLA,META"
  }
 },
 "output": {
  "type": "object"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "tickers"
     ],
     "properties": {
      "tickers": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "count",
      "tickers"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "tickers": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "ticker",
         "name",
         "market_status",
         "price",
         "change",
         "change_percent",
         "day",
         "previous_close",
         "updated"
        ],
        "properties": {
         "day": {
          "anyOf": [
           {
            "type": "object",
            "required": [
             "open",
             "high",
             "low",
             "close",
             "volume",
             "vwap"
            ],
            "properties": {
             "low": {
              "anyOf": [
               {
                "type": "number"
               },
               {
                "type": "null"
               }
              ]
             },
             "high": {
              "anyOf": [
               {
                "type": "number"
               },
               {
                "type": "null"
               }
              ]
             },
             "open": {
              "anyOf": [
               {
                "type": "number"
               },
               {
                "type": "null"
               }
              ]
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 1,
  "source": "x402stock",
  "tickers": [
   {
    "day": {
     "low": 305.02,
     "high": 310.94,
     "open": 309.625,
     "vwap": 307.97,
     "close": 307.51,
     "volume": 26924621
    },
    "name": "Apple Inc.",
    "price": 307.44,
    "change": -4.62,
    "ticker": "AAPL",
    "updated": "2026-05-29T19:58:00.000Z",
    "market_status": "open",
    "change_percent": -1.48,
    "previous_close": 312.06
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-6fa78a1e/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)