# Google Finance (/docs/google_finance)



Google Finance [#google-finance]

Quotes and company fundamentals for stocks, indices, mutual funds, currencies, futures and
crypto pairs, straight from Google Finance. Three endpoints: one to turn a name into a symbol,
one to read that symbol in full, and one standing overview of the world's markets that needs no
input at all.

Base URL: `/v1/google_finance/...`

Getting started [#getting-started]

Google Finance identifies an instrument by a compound id — `GOOGL:NASDAQ` for a stock,
`.INX:INDEXSP` for an index, `BTC-USD` or `EUR-USD` for a crypto or forex pair. `ticker-search`
is how you get one from a name.

```bash
# 1. Name to symbol (1 credit)
curl "https://www.socialcrawl.dev/v1/google_finance/ticker-search?keyword=Apple&category=stock" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

# 2. The full quote (5 credits)
curl "https://www.socialcrawl.dev/v1/google_finance/quote?keyword=GOOGL:NASDAQ" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"
```

Symbol lookup [#symbol-lookup]

`ticker-search` returns instruments matching a name, each with the exact `id` to pass to
`quote`, plus its ticker, display name, exchange, last published price and instrument type. `category`
restricts the class to `stock`, `index`, `mutual_fund`, `currency` or `futures` — `all` is the
default, and a class with no matches returns an empty list rather than an error. At 1 credit it
is cheap enough to resolve on demand, though the ids are stable so caching them is worth it.

Quotes [#quotes]

`quote` is the deep read, and it returns considerably more than a price: the last published price and
intraday graph, market cap, P/E, dividend yield, the 52-week range, the company profile,
financials, and the peer set Google groups the instrument with. That peer list is a useful seed
— feed it back into `quote` to build a comparison set without maintaining one yourself.

Pass the `id` from `ticker-search` rather than a bare ticker. A ticker alone is ambiguous across
exchanges, and the exchange suffix is what disambiguates it.

Markets overview [#markets-overview]

`markets` takes no symbol and no search term. It returns a snapshot of the major world indices
grouped by region, plus the day's most active stocks, biggest gainers and biggest losers, for 1
credit. It is the right endpoint behind a dashboard's default state, or a scheduled daily pull.

```bash
curl "https://www.socialcrawl.dev/v1/google_finance/markets" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"
```

Endpoints [#endpoints]

<PlatformEndpoints platform="google_finance" />

Read this before you build [#read-this-before-you-build]

**This is Google's data, not an exchange feed.** Prices are the delayed quotes Google publishes
publicly. It is the right source for research, screening and dashboards, and the wrong source
for anything that trades on the number.

**Symbol format differs by asset class.** Equities, ETFs and indices use `TICKER:EXCHANGE`;
forex and crypto use a hyphenated pair such as `EUR-USD`. Always take the shape from
`ticker-search` rather than constructing it.

**`location` changes the market context, not the currency of the instrument.** A quote is
reported in the instrument's own currency whatever `location` you pass.

Notes [#notes]

* All endpoints use `GET` with query parameters
* Authentication via the `x-api-key` header
* Responses follow the unified SocialCrawl schema
* `quote` is 5 credits; `ticker-search` and `markets` are 1 credit each
* `language` accepts a DFS name (`English`) or a two-letter code (`en`), and `location` a DFS
  name (`United States`) or a numeric code (`2840`)