Quick answer
Finnhub combines stock, FX and crypto prices with fundamentals, estimates, earnings, news, transcripts and alternative data behind one API key, sent as token= or the X-Finnhub-Token header. All plans share a hard ceiling of 30 calls per second; historical candles and several datasets require a paid plan, so check your plan’s access before relying on them.
Finnhub API at a glance
- Pricing
- Free tier; paid from $49.99/mo
- Availability
- Worldwide
- Paper trading
- Not applicable (data only)
- Integration type
- REST + API key
- In AlgoGP
- Built in: data adapter (Pro)
- REST base
https://finnhub.io/api/v1- Auth
token=parameter orX-Finnhub-Tokenheader- Ceiling
- 30 calls/second on every plan; free 60/minute
- Candles
/stock/candle,/forex/candle,/crypto/candle- WebSocket
- Trades, one connection per key
Candles and symbols
Candle endpoints take resolution (1, 5, 15, 30, 60, D, W, M) and Unix from/to, and return parallel arrays t, o, h, l, c, v with s: "ok". FX and crypto symbols include the venue: OANDA:EUR_USD, BINANCE:BTCUSDT.
Use Finnhub in AlgoGP
Finnhub is read by the generated data_sources.py. Turn it on from config.json under filters.sentiment. In-app backtests replay news and sentiment from dated, keyless archives, so a key, if any, is only used when the exported live.py runs; store it in the project’s Keys & secrets or a local .env.
| Key | What it is |
|---|---|
FINNHUB_API_KEY | Finnhub API key from your dashboard. |
.env.New to Finnhub? Follow the step-by-step Finnhub API key guide.
Finnhub API: frequently asked questions
Is Finnhub free?
Yes, there is a free tier (60 calls/minute) for personal use; historical candles and premium datasets need a paid plan.
Can I use Finnhub data commercially?
Personal plans are for individual use; commercial use and redistribution require an enterprise plan.
What is the Finnhub rate limit?
30 calls per second on all plans, plus per-minute limits by plan.
Turn Finnhub data into a tested strategy
Backtest an idea in the browser, then export Python whose live loop reads candles straight from Finnhub with your own key.
- Generated Finnhub candle fetcher, closed bars only
- An AI copilot that writes and revises the rules
- Pair it with Alpaca, Binance, OANDA or another broker
Free plan, no card required. Finnhub is included with Pro.
Finnhub alternatives
- Financial Modeling Prep API Built into AlgoGP (data)Fundamentals, earnings, transcripts and end-of-day prices for global equities in one REST API.
- Twelve Data API Built into AlgoGP (data)One API for global stocks, forex, crypto and ETFs with 1-minute to monthly bars and a generous free plan.
- Massive (Polygon.io) API Built into AlgoGP (data)Institutional-grade US stock, options, forex and crypto aggregates; Polygon.io renamed to Massive in 2025.
- EODHD API Built into AlgoGP (data)EOD Historical Data: global end-of-day and intraday prices for 150k+ tickers, fundamentals, FX and crypto at low cost.
Comparisons
Independent guide. AlgoGP is not affiliated with Finnhub. Limits, prices and availability change; confirm them in the official documentation. Nothing here is investment advice.