# Google Finance API — live quotes (stocks, ETFs, funds, indexes, futures, FX, crypto), charts, financial statements, earnings, transcripts, analyst ratings, news, insider and politician trades, market movers, sectors and earnings / IPO / economic calendars

> Live price snapshot of one listing: price, change, previous close, open / high / low, 52-week range, volume, average volume, market cap, P/E, EPS, dividend yield, beta, the extended-hours price (pre-market / after hours) and the trading session. Works for stocks, ETFs, funds, indexes, futures, currencies and crypto.
> ReefAPI engine `google-finance` · 27 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/google-finance/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/google-finance/v1/quote — 1 credit
Live price snapshot of one listing: price, change, previous close, open / high / low, 52-week range, volume, average volume, market cap, P/E, EPS, dividend yield, beta, the extended-hours price (pre-market / after hours) and the trading session. Works for stocks, ETFs, funds, indexes, futures, currencies and crypto.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** symbol, ticker, exchange, name, type, link, price, change, change_percent, previous_close, currency, country, timezone, last_updated_at, regular_close_at, extended_hours{session, price, change, change_percent, updated_at}, market_hours{opens_at, closes_at}, pair, google_mid, open, day_high, day_low, year_high, year_low, volume, average_volume, market_cap, pe_ratio, eps, dividend_yield_percent, ex_dividend_date, beta, shares_outstanding, primary_exchange

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/quotes — 1 credit
Up to 50 live quotes in ONE upstream request (the site's own multi-symbol quote call). Symbols the site does not know are listed in `not_found` instead of failing the call. Bare tickers are resolved together in one extra request.

**Parameters:**
- `symbols` (array, required) — 1-50 symbols in any form `symbol` accepts.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** count, quotes[] (the quote row: symbol, name, type, price, change, change_percent, previous_close, currency, extended_hours, market_hours, last_updated_at…), not_found[]

**Example request body:**
```json
{
  "symbols": [
    "AAPL:NASDAQ",
    "RELIANCE:NSE",
    "BTC-USD",
    "EUR-USD"
  ]
}
```

### POST https://api.reefapi.com/google-finance/v1/details — 1 credit
Everything on the quote page's Overview: the quote and key statistics, the company profile (description, CEO, employees, founded, headquarters, sector, industry, website, Wikipedia), fund facts (expense ratio, net assets, yield, category, Morningstar rating), futures facts (settlement, open interest), the currency / crypto legs, the logo, and the TipRanks news-sentiment outlook.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + logo + quote{…} + key_stats{…} + profile{name, description, ceo, employees, founded_date, headquarters{street, city, region, country, country_code}, sector, industry, website, wikipedia_link} + fund{…} + futures{…} + currencies[] + private_company{…} + news_sentiment{bullish_percent, neutral_percent, bearish_percent, score, sector_average{…}, articles_last_week, weekly_average_articles, buzz_ratio}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/chart — 1 credit
Price history exactly as the page's chart requests it. Window mode: 1D (1-minute points of the session + after hours; 5-minute candles), 5D (30-minute), 1M / 6M / YTD / 1Y (daily), 5Y / MAX (weekly; AAPL MAX: 2,088 weekly bars from 1986-11-14). Range mode: start_date / end_date with an interval (1min … 1week) always returns OHLC candles. `compare` adds up to 7 more symbols in the same request (the page's Compare).

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `window` (enum, optional, default "1D") — The chart's range buttons. [one of: 1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX]
- `start_date` (string, optional) — Range mode start, YYYY-MM-DD.
- `end_date` (string, optional) — Range mode end, YYYY-MM-DD (default today).
- `interval` (enum, optional) — Range mode bar size (default picked from the span: ≤7 days 5min, ≤31 days 30min, ≤5 years 1day, else 1week). [one of: 1min, 5min, 15min, 30min, 1hour, 1day, 1week]
- `candles` (boolean, optional, default false) — Window mode: OHLC candles instead of line points.
- `compare` (array, optional) — Up to 7 more symbols on the same chart.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + window | start_date/end_date + price, previous_close, currency, format (line|candles), interval, interval_seconds, count, prices[] (line: time, price, change, change_percent, volume, session; candles: time, open, high, low, close, volume, session), comparisons[]

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/financials — 1 credit
Income statement, balance sheet and cash flow — every quarter and fiscal year Google holds (AAPL: back to 1999), newest first, 94 line items per period, in the company's reporting currency.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `period` (enum, optional, default "quarterly") — quarterly or annual. [one of: quarterly, annual]
- `limit` (integer, optional) — How many periods (default: all the site returns) to return (1-200, measured maximum).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + period, currency, total_periods, count, periods[]{fiscal_year, fiscal_quarter, period_end_date, currency, income_statement{…26}, balance_sheet{…46}, cash_flow{…22}}

**Example request body:**
```json
{
  "symbol": "MSFT:NASDAQ",
  "limit": 4
}
```

### POST https://api.reefapi.com/google-finance/v1/earnings — 1 credit
Every quarter Google tracks for the company: the reported ones (revenue and EPS against the estimate, surprise, beat / miss, normalized EPS) and the scheduled ones (date, estimates).

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + next_report{…} + upcoming[] + reported[] (fiscal_year, fiscal_quarter, period_end_date, report_at, is_date_confirmed, currency, eps{actual, estimate, surprise_percent, gaap_as_reported}, normalized_eps{actual, estimate}, revenue{actual, estimate, surprise_percent}, result)

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/earnings_call — 1 credit
An earnings call: the timed transcript by speaker, audio links, the filed documents, and for the latest call the AI highlights, concerns and the 'At a glance' points with their sources.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `fiscal_year` (integer, optional) — Fiscal year of an older call (with fiscal_quarter). Default: the latest call.
- `fiscal_quarter` (integer, optional) — 1-4, with fiscal_year.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + fiscal_year, fiscal_quarter, has_transcript, duration_seconds, audio{hls, mp3, live_stream}, documents[], transcript_files{json, live_jsonl}, highlights[], concerns[], at_a_glance[], segment_count, transcript[]{speaker, role, company, start_seconds, end_seconds, text}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/analyst_ratings — 1 credit
Wall Street analyst consensus (TipRanks): buy / hold / sell counts, 12-month price target low / average / high with upside, and every individual rating with firm, action, price target, date, the source article and the analyst's track record.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + price, currency, consensus, analyst_count, buy_count, hold_count, sell_count, price_target{low, average, high, upside_percent, currency}, ratings_count, ratings[]

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/analysis — 1 credit
The quote page's AI analysis: a summary plus the bullish and bearish arguments, each with its cited news sources, and the TipRanks news-sentiment outlook.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + summary, bullish_view[]{title, text, sources[]}, bearish_view[], news_sentiment{…}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/key_moments — 1 credit
The chart's 'Key moments': the stock's biggest recent moves, each dated, with the close, the move in percent, an AI explanation, tags and the news sources behind it.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, moments[]{date, title, explanation, direction, close_price, change_percent, tags[], sources[]}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/news — 1 credit
News about one symbol: the page's 'News stories' from web sources and from Google's news partners (WSJ, Barron's, MarketWatch …), merged newest first.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `limit` (integer, optional, default 20) — How many articles to return (1-100, measured maximum).
- `source` (enum, optional, default "all") — all (both feeds), web or partners. [one of: all, web, partners]
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, news[]{title, link, source, snippet, thumbnail, source_icon, published_at, feed}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/insider_transactions — 1 credit
Corporate insiders' buys and sells (SEC Form 4 via TipRanks) from the quote page's Holdings tab, newest first, paged by cursor.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `cursor` (string, optional) — next_cursor from the previous page.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, next_cursor, has_more, transactions[]{insider, position, transaction_type, classification, transaction_code, date, shares, value, currency, sec_filing_link}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/politician_trades — 1 credit
US Congress members' disclosed trades of the stock (Holdings tab → Politicians), newest first, paged by cursor.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `cursor` (string, optional) — next_cursor from the previous page.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, next_cursor, has_more, trades[]{politician{id, name, full_name, chamber, party, district}, transaction_type, transaction_date, disclosure_date, amount{range, min_usd, max_usd}, owner}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/politician_holdings — 1 credit
US Congress members' disclosed holdings of the stock (share ranges by disclosure year), paged by cursor.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `cursor` (string, optional) — next_cursor from the previous page.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, next_cursor, has_more, holdings[]{politician{…}, asset_type, owner, disclosure_year, shares{min, mid, max}}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/prediction_markets — 1 credit
Kalshi / Polymarket prediction markets Google links to the symbol: question, outcome, YES probability, total and average volume in USD.

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, markets[]{symbol, question, outcome, platform, probability_percent, change, total_volume_usd, average_volume_usd, event_symbol, event_title, link, last_updated_at}

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/similar — 1 credit
Listings Google shows as related to the symbol, with live quotes (up to 24, measured).

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `limit` (integer, optional, default 24) — How many listings to return (1-24, measured maximum).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, similar[] (quote rows)

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/related — 1 credit
The 'Related stocks' card with earnings: each peer's live quote and its latest reported quarter (revenue and EPS against the estimates).

**Parameters:**
- `symbol` (string, required) — TICKER:EXCHANGE as Google Finance writes it (AAPL:NASDAQ, RELIANCE:NSE, 7203:TYO, SAP:ETR, HSBA:LON, .INX:INDEXSP, VFIAX:MUTF, ESW00:CME_EMINIS), a currency or crypto pair (EUR-USD, BTC-USD), a google.com/finance/quote link, a knowledge-graph id (/m/07zmbvf) or a bare ticker (AAPL, resolved through the site's own search: one extra request).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** identity + count, related[] (quote row + latest_earnings{…})

**Example request body:**
```json
{
  "symbol": "AAPL:NASDAQ"
}
```

### POST https://api.reefapi.com/google-finance/v1/convert — 1 credit
Convert an amount between two currencies or cryptocurrencies at Google Finance's live rate.

**Parameters:**
- `from_currency` (string, required) — ISO code or crypto symbol.
- `to_currency` (string, required) — ISO code or crypto symbol.
- `amount` (number, optional, default 1) — Amount of from_currency.
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** from_currency, to_currency, from_currency_name, to_currency_name, amount, converted_amount, exchange_rate, change, change_percent, previous_close, type, link, last_updated_at

**Example request body:**
```json
{
  "from_currency": "USD",
  "to_currency": "INR"
}
```

### POST https://api.reefapi.com/google-finance/v1/search — 1 credit
Google Finance's search box: stocks, ETFs, mutual funds, indexes, futures, currencies, crypto, private companies and prediction markets, best match first (about 5 per asset class, as the site returns).

**Parameters:**
- `query` (string, required) — Company, ticker or asset name.
- `type` (enum, optional) — Keep one asset class. [one of: stock, etf, mutual_fund, index, futures, currency, cryptocurrency, prediction_market, prediction_event, private_company]
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** query, count, results[] (quote rows; prediction events carry markets[])

**Example request body:**
```json
{
  "query": "tesla"
}
```

### POST https://api.reefapi.com/google-finance/v1/trending — 1 credit
What Google Finance's empty search box suggests: trending listings, indexes, funds and prediction markets.

**Parameters:**
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** count, results[]

**Example request body:**
```json
{
  "language": "en"
}
```

### POST https://api.reefapi.com/google-finance/v1/market_summary — 1 credit
The home page's market tabs: headline indexes for the US, Europe, Asia, India and Latin America, major currencies, crypto and futures, with live quotes.

**Parameters:**
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** groups[]{group, group_id, count, quotes[] (quote row + short_name)}

**Example request body:**
```json
{
  "language": "en"
}
```

### POST https://api.reefapi.com/google-finance/v1/market_movers — 2 credits
Most active, top gainers and top losers of one country's market (up to 50 each), as the site shows them to a visitor from that country.

**Parameters:**
- `market` (enum, optional, default "US") — The country whose market the page shows (movers, sectors, earnings calendar and top stories follow the visitor's country on the site). Measured on 2026-11-15 for these 18. [one of: US, GB, DE, FR, IN, JP, CA, AU, BR, HK, KR, ES, IT, MX, SG, TR, NL, CH]
- `type` (enum, optional, default "all") — Which list. [one of: all, most_active, gainers, losers]
- `limit` (integer, optional, default 20) — How many rows per list to return (1-50, measured maximum).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** market + most_active[] / gainers[] / losers[] (quote rows + rank)

**Example request body:**
```json
{
  "market": "US"
}
```

### POST https://api.reefapi.com/google-finance/v1/sectors — 2 credits
The equity-sector index list of a market with the day's move, open, high and low (US: S&P sector indexes, Europe: STOXX 600 sectors, India: NIFTY sectors).

**Parameters:**
- `market` (enum, optional, default "US") — The country whose market the page shows (movers, sectors, earnings calendar and top stories follow the visitor's country on the site). Measured on 2026-11-15 for these 18. [one of: US, GB, DE, FR, IN, JP, CA, AU, BR, HK, KR, ES, IT, MX, SG, TR, NL, CH]
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** market, title, count, sectors[] (quote row + sector, open, day_high, day_low)

**Example request body:**
```json
{
  "market": "US"
}
```

### POST https://api.reefapi.com/google-finance/v1/earnings_calendar — 2 credits
The earnings calendar of a market: yesterday, today, tomorrow, this week, next week, or the home page's upcoming list — each row with the report time, fiscal quarter and the EPS / revenue estimates.

**Parameters:**
- `market` (enum, optional, default "US") — The country whose market the page shows (movers, sectors, earnings calendar and top stories follow the visitor's country on the site). Measured on 2026-11-15 for these 18. [one of: US, GB, DE, FR, IN, JP, CA, AU, BR, HK, KR, ES, IT, MX, SG, TR, NL, CH]
- `period` (enum, optional, default "next_week") — Which tab of the calendar. [one of: yesterday, today, tomorrow, this_week, next_week, upcoming]
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** market, period, count, earnings[]{symbol, name, link, event, date, fiscal_year, fiscal_quarter, period_end_date, report_at, is_date_confirmed, currency, eps{…}, normalized_eps{…}, revenue{…}}

**Example request body:**
```json
{
  "market": "US"
}
```

### POST https://api.reefapi.com/google-finance/v1/economic_calendar — 1 credit
The home page's economic calendar (LSEG data): upcoming releases worldwide with country, release time, reference period, actual, forecast and prior.

**Parameters:**
- `country` (string, optional) — Keep one country (ISO code, e.g. US, IN, JP); applied by this API on the site's list.
- `limit` (integer, optional) — How many events (default all) to return (1-500, measured maximum).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** count, events[]{id, name, full_name, country_code, release_at, reference_period, actual, forecast, prior, value_format}

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/google-finance/v1/ipo_calendar — 1 credit
IPOs Google Finance tracks: upcoming listings with the filing range and estimated deal size, recent IPOs with the IPO price, first-day close and return, and filings — with industry, SEC filing, underwriters, revenue, net income, quiet-period and lock-up dates.

**Parameters:**
- `limit` (integer, optional, default 100) — How many IPOs (the site's list holds about 450) to return (1-500, measured maximum).
- `status` (enum, optional) — Keep one status (applied by this API on the site's list). [one of: upcoming, recent, filed]
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** count, ipos[]{id, symbol, name, description, industry, status, ipo_date, expected, pricing_date, filing_date, sec_filing_link, currency, ipo_price, first_day_close, first_day_return_percent, price_range{low, high}, shares_offered, deal_size, market_cap, shares_outstanding, percent_offered, revenue, revenue_year, revenue_growth_percent, net_income, net_income_year, lead_underwriters[], co_managers[], quiet_period_end, lockup_end, lockup_days, latest_price, return_since_ipo_percent}

**Example request body:**
```json
{
  "language": "en"
}
```

### POST https://api.reefapi.com/google-finance/v1/market_news — 2 credits
The home page's news for a market: the AI-written market summary stories with their cited sources, the partner top stories, and the latest-news feed.

**Parameters:**
- `market` (enum, optional, default "US") — The country whose market the page shows (movers, sectors, earnings calendar and top stories follow the visitor's country on the site). Measured on 2026-11-15 for these 18. [one of: US, GB, DE, FR, IN, JP, CA, AU, BR, HK, KR, ES, IT, MX, SG, TR, NL, CH]
- `limit` (integer, optional, default 20) — How many articles per list to return (1-60, measured maximum).
- `language` (string, optional, default "en") — Language of names, descriptions and AI text (the site's `hl`): en, de, fr, ja, hi, pt-BR … Numbers and currencies do not change with it.

**Returns:** market, market_summary[]{title, summary, sources[]}, top_stories[], latest_news[]

**Example request body:**
```json
{
  "market": "US"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=google-finance
- Human docs page: https://reefapi.com/docs/google-finance
- Overview page: https://reefapi.com/google-finance-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
