# TradeOS Market Snapshot

> TradeOS Market Snapshot is a paid API for AI agents from ai.tradeos.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-20).

Retrieve the latest real-time market snapshot for a stock, ETF, forex pair, commodity (e.g. gold), or cryptocurrency, including current quotes, trades, and daily summaries.

## Facts

- Endpoint: POST https://ai.tradeos.xyz/api/x402/get_market_snapshot?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradeos-market-snapshot-47140937
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rBYubyxdpcSK2HYu_fKo_

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 tradeos-market-snapshot-47140937 -d '<json body>'
```

Example prompt: What is the current market snapshot for AAPL — give me the latest quote, last trade, and daily summary?

## When to prefer this

Use this endpoint when you need a single, real-time market snapshot for one instrument — a stock, ETF, forex pair, commodity, or cryptocurrency — including quote and daily summary data. Prefer this over candle history endpoints when you only need the current price/state, not historical OHLCV bars. For discovering a ticker symbol, use search_tickers first; for chart analysis, use get_market_technical_analysis.

## Known failure modes

- Invalid ticker format — FX/metals must use C: prefix, crypto must use X: prefix
- Ticker not found or not supported by the data provider
- Market closed with no recent data available
- Payment failure or insufficient USDC balance for the $0.01 per-call fee
- Malformed ticker string rejected by pattern validation

## How this service works

Retrieve the latest available market snapshot for one stock, ETF, gold, forex pair or cryptocurrency, including available quotes, trades and daily summaries. Use search_tickers to find a ticker, get_market_candles for its OHLCV history, and get_market_technical_analysis for written chart analysis. Popular examples include AAPL, SPY, gold XAUUSD (C:XAUUSD), EURUSD (C:EURUSD), BTCUSD (X:BTCUSD), and ETHUSD (X:ETHUSD). FX/metals require C:; crypto requires X:.

## Output

A market snapshot object containing the latest available quote (bid, ask, mid), most recent trade price and volume, and daily summary statistics (open, high, low, close, volume) for the requested ticker symbol.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ticker": {
   "type": "string",
   "pattern": "^(?:[CX]:)?[A-Za-z0-9._]+$",
   "maxLength": 64,
   "minLength": 1,
   "description": "AAPL, SPY, C:EURUSD or X:BTCUSD; no spread expressions"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradeos-market-snapshot-47140937/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai.tradeos.xyz](https://www.zero.xyz/host/ai.tradeos.xyz/llms.txt)
