# Finnhub Stock API

**Provider:** Finnhub
**Category:** finance
**Base URL:** `https://finnhub.io/api/v1`
**Auth:** api-key — `X-Finnhub-Token: YOUR_API_KEY`
**Rate Limit:** 60 calls/min (free)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://finnhub.io/docs/api

## Description

Finnhub provides real-time RESTful APIs and WebSocket streams for global stock markets. Features include real-time and historical quotes, SEC filings, earnings call transcripts, analyst recommendations, insider transactions, earnings surprises, economic calendar events, news sentiment, and alternative data like satellite imagery and foot traffic. Covers US, EU, and Asian markets.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://finnhub.io/api/v1/quote` | Real-time stock quote (price, change, volume) |
| GET | `https://finnhub.io/api/v1/stock/candle` | Historical OHLCV candlestick data |
| GET | `https://finnhub.io/api/v1/company-earnings` | Earnings history and EPS surprise data |
| GET | `https://finnhub.io/api/v1/stock/recommendation` | Analyst buy/hold/sell recommendations |
| GET | `https://finnhub.io/api/v1/news` | Latest financial and market news with sentiment |
| GET | `https://finnhub.io/api/v1/stock/insider-transactions` | Insider buying and selling data |

## Authentication

Send your API token in the X-Finnhub-Token request header, or as the token query parameter.

```
X-Finnhub-Token: YOUR_API_KEY
```

## Sample Request

```bash
curl "https://finnhub.io/api/v1/quote?symbol=AAPL" -H "X-Finnhub-Token: $FINNHUB_API_KEY"
```

## Sample Response

```json
{
  "c": 182.63,
  "d": 1.85,
  "dp": 1.0239,
  "h": 183.12,
  "l": 180.97,
  "o": 181.05,
  "pc": 180.78,
  "t": 1704067200
}
```

## Pricing Details

Free: 60 calls/min, US stocks only. Growth $14/mo: 300 calls/min. All-in-One $60/mo: 600 calls/min, global coverage + premium data.

---

*Source: [API Map](https://apimap.dev/apis/finnhub/) — CC BY 4.0*