Google Finance quote schema - cloro

Google

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...

Google Search endpoint

Navigate to header: Finance quote structure

Navigate to header: Key stats

Navigate to header: Response example