# CNBC API: Get market snapshot

> Returns CNBC levels and changes for major stock indexes and U.S. futures, optionally by region. Quote times and market-status labels are null when CNBC does not show them; quotes may be delayed.

Unofficial. Not affiliated with or endorsed by CNBC.

- Page: https://fous.com/methods/cnbc.com/get-market-snapshot
- Method: `cnbc.com/get_market_snapshot`, version 1
- Website: cnbc.com
- Returns: name, level, change points and percent, as-of time, market status, CNBC symbol, page URL
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `region` | string | no | `"us"` | Market region to include, such as "europe". Defaults to "us". One of "us", "europe", "asia", "all". Default "us". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "region": "us"
}
```

Its output:

```json
{
  "markets": [
    {
      "name": "Dow Jones Industrial Average",
      "as_of": null,
      "level": 52867.98,
      "page_url": "https://www.cnbc.com/quotes/.DJI",
      "cnbc_symbol": ".DJI",
      "change_points": 11.89,
      "market_status": null,
      "change_percent": 0.02
    },
    {
      "name": "S&P 500",
      "as_of": null,
      "level": 7663.43,
      "page_url": "https://www.cnbc.com/quotes/.SPX",
      "cnbc_symbol": ".SPX",
      "change_points": -93.74,
      "market_status": null,
      "change_percent": -1.21
    },
    {
      "name": "Nasdaq Composite",
      "as_of": null,
      "level": 26008.859,
      "page_url": "https://www.cnbc.com/quotes/.IXIC",
      "cnbc_symbol": ".IXIC",
      "change_points": -693.999,
      "market_status": null,
      "change_percent": -2.6
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"cnbc.com/get_market_snapshot","input":{"region":"us"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the current levels and daily changes for the major U.S. stock indexes?
- Show me how Asian stock indexes are trading right now, including point and percent changes.
- Give me a snapshot of European market indexes with their latest levels and whether the market is open.
- I need the S&P 500, Dow, and Nasdaq futures levels from cnbc.com along with their as-of times.
- Pull a combined view of all global regions' index levels and changes, noting any delayed quotes.

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "region": {
      "enum": [
        "us",
        "europe",
        "asia",
        "all"
      ],
      "type": "string",
      "default": "us",
      "description": "Market region to include, such as \"europe\". Defaults to \"us\"."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "markets"
  ],
  "properties": {
    "markets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "level",
          "change_points",
          "change_percent",
          "as_of",
          "market_status",
          "cnbc_symbol",
          "page_url"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Index or futures name."
          },
          "as_of": {
            "type": [
              "string",
              "null"
            ],
            "description": "Time of the quote with its UTC offset, if provided by CNBC."
          },
          "level": {
            "type": [
              "number",
              "null"
            ],
            "description": "Most recent reported level."
          },
          "page_url": {
            "type": "string",
            "description": "CNBC quote page."
          },
          "cnbc_symbol": {
            "type": "string",
            "description": "CNBC quote symbol.",
            "x-fous-developer": true
          },
          "change_points": {
            "type": [
              "number",
              "null"
            ],
            "description": "Change from the previous close in points."
          },
          "market_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "CNBC market-status label if one is explicitly provided."
          },
          "change_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Change from the previous close as a percentage number."
          }
        },
        "additionalProperties": false
      },
      "description": "Market quotes in the requested regional order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [CNBC API: List headlines](https://fous.com/methods/cnbc.com/list-headlines.md): Lists CNBC article headlines in the order they appear on a public news section page, with summary, time, authors and image.
- [CNBC API: Search articles](https://fous.com/methods/cnbc.com/search-news.md): Searches CNBC-published articles by keyword, with optional publication date range, sort order and pagination. Excludes videos, wire stories and press releases.
- [Google API: List market indexes](https://fous.com/methods/google.com/list-market-indexes.md): Lists major stock market indexes on Google Finance with their current levels, changes and quote times. Quotes may be delayed, and indexes Google does not show are left out.
- [Finviz API: Get stock snapshot](https://fous.com/methods/finviz.com/get-stock-snapshot.md): Get a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null.
- [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.
- [CNN API: List headlines by section](https://fous.com/methods/cnn.com/list-headlines.md): Lists CNN headlines in the order shown on a chosen news section page (top stories, US, world, politics, business, health, entertainment or science), with each story's summary, publication time, authors and image when available. Promotions and video-only items are left out.
- [MSN API: Get stock quote](https://fous.com/methods/msn.com/get-stock-quote.md): Gets a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours.
- [Investing.com API: Get commodity prices](https://fous.com/methods/investing.com/get-commodity-prices.md): Gets current quoted prices for energy, metals, and agricultural commodities from Investing.com's real-time futures page, optionally for one commodity. Some quotes may be delayed or indicative; units are null when the contract specification is missing.
- [All CNBC methods](https://fous.com/methods/cnbc.com.md)