# x402stock Ticker Snapshot

> x402stock Ticker Snapshot is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status healthy (last checked 2026-10-11, last successful call 2026-10-01).

Returns a single-call real-time snapshot of a US stock ticker including last quote, last trade, today's OHLC/volume/VWAP, previous-day OHLC, and price change vs previous close.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/snapshot/{ticker}?utm_source=zero.xyz
- Price: $0.01/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-11
- Last successful call: 2026-10-01
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-ticker-snapshot-a2b377c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KRQoHI0yYMF-PCsDYRYs6

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 agents-x402stock-xyz-x402stock-ticker-snapshot-a2b377c4
```

Example prompt: What's the current snapshot for AAPL — last trade price, today's OHLC and VWAP, and how much it's up or down vs yesterday's close?

## When to prefer this

Choose this endpoint when you need a comprehensive real-time snapshot of a single US-listed stock in one call — covering quote, trade, OHLC, VWAP, and day-over-day change — without needing an API key. Ideal for agents that need to pay per-use in USDC and want all essential market state for a ticker in a single round-trip rather than calling separate quote, trade, and bar endpoints.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty data
- Ticker not US-listed may return no data
- Market closed hours may return stale or null last_quote/last_trade timestamps
- Payment failure via x402/USDC results in 402 response and no data
- Truncated response schema may omit some optional fields if data is unavailable

## How this service works

Returns a full ticker snapshot including last quote, last trade, OHLC, and prev close.

## Output

A JSON object containing: the ticker symbol, data source, and an 'as_of' timestamp. The 'data' field includes: last_quote (bid/ask price and size), last_trade (price, size, exchange ID, timestamp, conditions), day (open/high/low/close/volume/VWAP for today), previous_day (open/high/low/close/volume/VWAP), last_minute_bar (OHLCV + VWAP + trade count + accumulated volume for the most recent minute), change (absolute price change vs previous close), and change_percent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker"
 ],
 "properties": {
  "ticker": {
   "type": "string",
   "description": "US-listed ticker symbol (uppercase), e.g. AAPL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ticker",
  "data",
  "source",
  "as_of"
 ],
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "day": {
     "type": "object",
     "required": [
      "open",
      "high",
      "low",
      "close",
      "volume"
     ],
     "properties": {
      "low": {
       "type": "number"
      },
      "high": {
       "type": "number"
      },
      "open": {
       "type": "number"
      },
      "vwap": {
       "type": "number"
      },
      "close": {
       "type": "number"
      },
      "volume": {
       "type": "number"
      }
     },
     "additionalProperties": false
    },
    "change": {
     "anyOf": [
      {
       "type": "number"
      },
      {
       "type": "null"
      }
     ]
    },
    "last_quote": {
     "type": "object",
     "required": [
      "bid_price",
      "bid_size",
      "ask_price",
      "ask_size",
      "timestamp"
     ],
     "properties": {
      "ask_size": {
       "type": "number"
      },
      "bid_size": {
       "type": "number"
      },
      "ask_price": {
       "type": "number"
      },
      "bid_price": {
       "type": "number"
      },
      "timestamp": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      }
     },
     "additionalProperties": false
    },
    "last_trade": {
     "type": "object",
     "required": [
      "price",
      "size",
      "exchange_id",
      "timestamp",
      "conditions"
     ],
     "properties": {
      "size": {
       "type": "number"
      },
      "price": {
       "type": "number"
      },
      "timestamp": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "conditions": {
       "type": "array",
       "items": {
        "type": "number"
       }
      },
      "exchange_id": {
       "type": "number"
      }
     },
     "additionalProperties": false
    },
    "previous_day": {
     "type": "object",
     "required": [
      "open",
      "high",
      "low",
      "close",
      "volume"
     ],
     "properties": {
      "low": {
       "type": "number"
      },
      "high": {
       "type": "number"
      },
      "open": {
       "type": "number"
      },
      "vwap": {
       "type": "number"
      },
      "close": {
       "type": "number"
      },
      "volume": {
       "type": "number"
      }
     },
     "additionalPropert
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-ticker-snapshot-a2b377c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)