> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Finance quote schema

> Schema for the quote of Google's market summary returned by the Google Search endpoint: name, ticker, price, currency, change, change percent, time and key stats of a stock, fund, index, future or crypto currency.

The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) returns the quote of Google's market summary, the price block on queries for a stock, a fund, an index, a future or a crypto currency ("aapl stock", "dax", "gold price", "bitcoin price"), as `result.financeQuote`, on desktop and mobile, with no flag and at no extra cost. `financeQuote` is omitted when the SERP has no market summary.

![Finance quote in Google Search](https://mintcdn.com/cloro/z6cqZNkxEqe4AYDd/images/google/search-finance-quote.webp?fit=max\&auto=format\&n=z6cqZNkxEqe4AYDd\&q=85\&s=28acc1a9892c6eb95a4b0e224b339d65)

Finance quote in Google Search

Values are text as Google shows them, in the language of the SERP (`348.22`, `26.544,21`, `7 762,12`). The chart is not returned. The currency converter ("usd to eur") shows a conversion rate, not a quote, and gives no `financeQuote`.

## Finance quote structure

`price` is always present. The other fields are included only when Google shows them.

| Field | Type | Description |
| - | - | - |
| `name` | string | Name of the instrument as shown ("Apple Inc", "DAX Performance Index", "Bitcoin") |
| `symbol` | string | Ticker symbol ("AAPL", "DAX", "BTC") |
| `exchange` | string | Exchange of the ticker, as Google Finance names it ("NASDAQ", "INDEXDB"). Absent on a crypto quote |
| `price` | string | Price as shown |
| `currency` | string | Currency of the price ("USD", "EUR", "GBX"). Absent on an index |
| `change` | string | Change today as shown, with its sign ("+4.23", "−121,83") |
| `changePercent` | string | Change today in percent as shown, without a sign ("1.23%", "0,75 %"). The sign is in `change` |
| `timestamp` | string | Date and time Google shows under the price ("Oct 23, 4:25 AM EDT"). See below |
| `keyStats` | array | The key stats under the chart, in page order. See below |

When the market is closed, `timestamp` is the time of Google's latest after-hours or pre-market quote, so it can be later than the close that `price` shows.

### Key stats

Each stat is a label and its value as shown, in the language of the SERP. The stats depend on the instrument: a stock has its market cap, P/E ratio and dividend, an index its previous close, a future its volume and open interest. On mobile, a stock or a fund has its 52-week high and low as one range ("243.42 - 355.91"). A crypto quote has no key stats.

| Field | Type | Description |
| - | - | - |
| `key` | string | Label as shown ("Open", "Mkt cap", "P/E ratio", "Eröffnung", "始値") |
| `value` | string | Value as shown ("344.94", "5.08T", "0.31%") |

## Response example

A response to `aapl stock` in the United States, on desktop:

```json theme={null}
{
  "success": true,
  "result": {
    "financeQuote": {
      "name": "Apple Inc",
      "symbol": "AAPL",
      "exchange": "NASDAQ",
      "price": "348.22",
      "currency": "USD",
      "change": "+4.23",
      "changePercent": "1.23%",
      "timestamp": "Oct 23, 4:25 AM EDT",
      "keyStats": [
        { "key": "Open", "value": "344.94" },
        { "key": "High", "value": "348.36" },
        { "key": "Low", "value": "342.28" },
        { "key": "Mkt cap", "value": "5.08T" },
        { "key": "P/E ratio", "value": "39.92" },
        { "key": "52-wk high", "value": "348.36" },
        { "key": "Dividend", "value": "0.31%" },
        { "key": "Qtrly Div Amt", "value": "0.27" },
        { "key": "52-wk low", "value": "243.42" }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.