# SqueezeOS Market Snapshot

> SqueezeOS Market Snapshot is a paid API for AI agents from squeezeos-api.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns an evidence-backed US equity market snapshot with the latest observed price, recent daily OHLCV bars, and deterministic range/return/volume context with explicit provenance and freshness indicators.

## Facts

- Endpoint: GET https://squeezeos-api.onrender.com/api/market/snapshot
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/squeezeos-market-snapshot-306f7081
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q-kbnVRYoJ69XXWmD3PO5

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 squeezeos-market-snapshot-306f7081
```

Example prompt: Pull me a SqueezeOS market snapshot for NVDA with the last 20 daily OHLCV bars — I want the evidence-backed price, range context, and provenance info.

## When to prefer this

Choose this endpoint when you need a transparent, evidence-backed US equity market snapshot with explicit provenance and freshness guarantees — especially when data sourcing transparency matters (e.g. for auditable research or algorithmic pipelines). Prefer it over generic market data APIs when you want OHLCV bar history bundled with contextual range/return/volume metrics in a single call, or when you need clear labeling that distinguishes real-time vs. previous-session data.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error or empty result
- Bars parameter outside the 10-30 range may be rejected or clamped
- Market data may reflect previous session prices outside trading hours, clearly labeled as such
- Payment failure via x402 protocol results in 402 response before data is returned
- Network timeouts possible if upstream data provider is slow

## How this service works

Stock market snapshot API. Get a live/latest US equity quote plus recent daily OHLCV price bars for a ticker symbol.

## Output

A JSON object containing the latest observed market price for the requested US equity ticker, recent daily OHLCV (open, high, low, close, volume) bars for the specified number of days, deterministic range and return metrics, volume context, explicit provenance information about data sources, and freshness/timestamp indicators clarifying whether data is from the current or previous session.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "bars": {
       "type": "string",
       "description": "Number of recent daily OHLCV bars, 10-30 Search intents: market snapshot, stock quote, ohlcv, price bars, equity market data."
      },
      "symbol": {
       "type": "string",
       "pattern": "^[A-Z0-9.]{1,10}$",
       "description": "US equity ticker symbol Search intents: market snapshot, stock quote, ohlcv, price bars, equity market data."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "quote": {
   "price": 0,
   "provider": "<live-provider>"
  },
  "status": "ready",
  "symbol": "SPY",
  "product": "SML Market Snapshot",
  "daily_bars": [
   {
    "low": 0,
    "high": 0,
    "open": 0,
    "time": "<provider-time>",
    "close": 0,
    "source": "<provider>",
    "volume": 0
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/squeezeos-market-snapshot-306f7081/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from squeezeos-api.onrender.com](https://www.zero.xyz/host/squeezeos-api.onrender.com/llms.txt)