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.
https://finnhub.io/api/v1
Auth type
API Key Header
Auth header
X-Finnhub-Token: YOUR_API_KEY
Rate limit
60 calls/min (free)
Pricing
Free tier available
Free quota
60 API calls/minute
Documentation
https://finnhub.io/docs/api
Endpoint status
Server online — HTTP 401 — server is online but path returned an error (may require auth)807ms
(checked Mar 29, 2026)
Builder score
B
71%
builder-friendly
Send your API token in the X-Finnhub-Token request header, or as the token query parameter.
X-Finnhub-Token: YOUR_API_KEY
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.
| Method | Path | Description |
|---|---|---|
| GET | /quote |
Real-time stock quote (price, change, volume) |
| GET | /stock/candle |
Historical OHLCV candlestick data |
| GET | /company-earnings |
Earnings history and EPS surprise data |
| GET | /stock/recommendation |
Analyst buy/hold/sell recommendations |
| GET | /news |
Latest financial and market news with sentiment |
| GET | /stock/insider-transactions |
Insider buying and selling data |
curl "https://finnhub.io/api/v1/quote?symbol=AAPL" -H "X-Finnhub-Token: $FINNHUB_API_KEY"
{
"c": 182.63,
"d": 1.85,
"dp": 1.0239,
"h": 183.12,
"l": 180.97,
"o": 181.05,
"pc": 180.78,
"t": 1704067200
}
Data sourced from API Map. Always verify pricing and rate limits against the official Finnhub documentation.