# Google Finance API

> Unofficial REST API wrapping Google Finance's internal batchexecute RPC endpoint. No API key required. Zero external dependencies.

Covers stocks, ETFs, indices, crypto pairs, and forex on every exchange Google Finance supports (NASDAQ, NYSE, IST, KRX, TYO, LSE, and more). Every endpoint answers a plain HTTP GET with JSON and needs no authentication.

## Docs

- [API reference](https://finance.hermestech.uk/index.html.md): Every endpoint, ticker format, and example in clean Markdown
- [OpenAPI 3.1 specification](https://finance.hermestech.uk/openapi.json): Machine-readable schema for every endpoint and response

## Ticker endpoints

- [Quote](https://finance.hermestech.uk/v1/quote/GOOGL:NASDAQ): Real-time price, change, and market data for a ticker
- [Company](https://finance.hermestech.uk/v1/company/AAPL:NASDAQ): Company description, CEO, sector, employees, and key metrics
- [Chart](https://finance.hermestech.uk/v1/chart/MSFT:NASDAQ?range=1M): Historical price and volume data points; range=1D|5D|1M|6M|YTD|1Y|5Y|MAX (default 1M)
- [News](https://finance.hermestech.uk/v1/news/TSLA:NASDAQ): Latest news articles related to the ticker
- [Financials](https://finance.hermestech.uk/v1/financials/GOOGL:NASDAQ?type=annual): Revenue, net income, EPS, margins, and P/E; type=annual|quarterly, both when omitted
- [Related](https://finance.hermestech.uk/v1/related/AAPL:NASDAQ): Stocks related to the given ticker
- [Classification](https://finance.hermestech.uk/v1/classification/AAPL:NASDAQ): Descriptive classification labels such as Most active or US listed security
- [Analyst](https://finance.hermestech.uk/v1/analyst/AAPL:NASDAQ): Curated news and analysis articles grouped by Google Finance
- [Context](https://finance.hermestech.uk/v1/context/AAPL:NASDAQ): The same instrument on other exchanges, with per-listing price and currency
- [Full](https://finance.hermestech.uk/v1/full/GOOGL:NASDAQ): Combined quote, company, chart, and news in a single batched request

## Market endpoints

- [Indices](https://finance.hermestech.uk/v1/market/indices): Global market indices: Dow, S&P 500, NASDAQ, DAX, Nikkei, and more
- [Movers](https://finance.hermestech.uk/v1/market/movers?category=gainers&count=10): Top gainers, losers, and most active stocks; count 1-100 (default 10)
- [Trending](https://finance.hermestech.uk/v1/market/trending): Currently trending stocks on Google Finance
- [Earnings](https://finance.hermestech.uk/v1/market/earnings): Upcoming earnings announcements
- [Headlines](https://finance.hermestech.uk/v1/market/headlines): Current top finance headline

## Live endpoints

- [Live stream](https://finance.hermestech.uk/v1/live): Server-Sent Events price stream for 8 tickers, refreshed every 15 seconds
- [Live snapshot](https://finance.hermestech.uk/v1/live/snapshot): One-shot JSON array of the cached live quotes; empty until the hub has data

## System endpoints

- [Health](https://finance.hermestech.uk/healthz): Service health and running version

## Ticker formats

- Stock: `SYMBOL:EXCHANGE`, for example `GOOGL:NASDAQ` or `THYAO:IST`
- Index: `.SYMBOL:EXCHANGE`, for example `.DJI:INDEXDJX`
- Crypto: `BASE-QUOTE`, for example `BTC-USD`
- Forex: `BASE-QUOTE`, for example `EUR-USD`
- ETF: `SYMBOL:EXCHANGE`, for example `SPY:NYSEARCA`

A bare symbol such as `AAPL` is rejected with HTTP 400; the exchange or quote currency is always required.

## Optional

- [Source code](https://github.com/KilimcininKorOglu/Google-Finance-Api): Go implementation, MIT licensed