# x402stock Full Market Snapshot

> x402stock Full Market Snapshot is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.04/call, status unknown (last checked 2026-10-29).

Returns a comprehensive, single-call snapshot covering US stocks, ETFs, options, forex, crypto, energy commodities, macro indicators, and market sentiment in one payload

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/full-market-snapshot?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-full-market-snapshot-1c39cd62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kFWrYYVzmD9BHzUmRaBrD

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-full-market-snapshot-1c39cd62
```

Example prompt: Give me a full market snapshot right now — stocks, crypto, forex, oil, and macro indicators all in one shot, so I can see where every major asset class stands.

## When to prefer this

Choose this endpoint when you need a broad, cross-asset market overview in a single API call rather than making multiple targeted queries. It is ideal for morning briefings, portfolio dashboards, macro research, and any agent workflow that needs simultaneous visibility into equities, crypto, forex, commodities, and macro data. Prefer this over individual feed endpoints when latency and request-count cost matter more than granularity, and when your use case spans multiple asset classes at once.

## Known failure modes

- Payment failure: insufficient USDC balance or x402 payment rejected — returns 402 Payment Required
- Rate or quota exceeded: too many requests in a short window — returns 429
- Upstream data provider outage: partial or empty payload fields with error indicators
- Invalid request format: returns 400 if unexpected query parameters are passed
- Endpoint not in catalog: requests to unlisted paths return 404

## How this service works

Whole-market snapshot: every US ticker's current price and day change in one call

## Output

A single JSON payload aggregating live and near-live data across US stocks, ETFs, options, forex pairs, crypto spot and on-chain perpetuals, energy commodities (crude, natural gas, gasoline), US and global macroeconomic indicators (Fed funds rate, CPI/PCE, jobs, GDP, Treasury debt and yields, World Bank indicators), recent SEC filings, congressional trades, and market sentiment metrics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tickers": {
   "type": "string",
   "minLength": 1,
   "description": "Optional comma-separated list of tickers to narrow results."
  },
  "include_otc": {
   "type": "boolean",
   "description": "Optional flag to include OTC names."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "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",
     "price",
     "change",
     "change_percent",
     "volume",
     "vwap",
     "updated"
    ],
    "properties": {
     "vwap": {
      "type": "number",
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "price": {
      "type": "number",
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "change": {
      "type": "number",
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "ticker": {
      "type": "string"
     },
     "volume": {
      "type": "number",
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "updated": {
      "type": "string",
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "change_percent": {
      "type": "number",
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-full-market-snapshot-1c39cd62/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)