Google Finance quote schema - cloro
Google Finance quote schema
Schema for the finance quote in Google’s market summary: name, ticker, price, currency, change and key stats of a stock, fund, index, future or crypto.
The
Google Search endpoint
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
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
.
Navigate to header: Finance quote structure 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.
Navigate to header: Key stats 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%“) |
Navigate to header: Response example Response example
A response to
aapl stock
in the United States, on desktop:
{
"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"
}
]
}
}
}
Was this page helpful?
Ask a question...