Finnhub API: Pricing, Free Limits and Alternatives (2026)

Finnhub API: Pricing, Free Limits and Alternatives (2026)
From Finnhub's pricing pages and API documentation, checked November 18, 2026.

Finnhub's documentation lists 118 endpoints. On November 18, 2026, 89 of them carried a Premium tag.

The Finnhub API is a stock and company data API with a free plan of 60 calls a minute and paid plans from $49.99 a month. The free tier covers real-time quotes, basic financials, insider transactions and SEC filings, but historical price candles and standardized financial statements are premium. Every plan except Enterprise is licensed for personal use only.

Key takeaway: Finnhub's free plan allows 60 API calls a minute, but 89 of its 118 documented endpoints are premium, including price candles and standardized financials. Market data plans start at $49.99 a month billed quarterly, fundamentals at $50 a month per market, and All-in-One at $3,500. Every self-serve plan is personal use; commercial use needs Enterprise.
Edgrapi serves SEC filings and US federal data as clean JSON, plus an MCP server for AI agents. Free key, no card.Get a free API key

What is the Finnhub API?

The Finnhub API is a REST and websocket API for market data, company fundamentals, estimates, alternative data and economic data. You authenticate with a token, either as a URL parameter or an X-Finnhub-Token header, and get JSON back. Its documentation listed 118 endpoints on November 18, 2026, covering US and global stocks, forex, crypto, bonds, ETFs and mutual funds.

The breadth is the pitch. One key reaches quotes, earnings calendars, insider trades, patents and even Senate lobbying data.

Finnhub also publishes official libraries for Python, Go, JavaScript, Ruby, Kotlin and PHP, listed in its API documentation.

Without a key, every endpoint refuses you. My keyless request to the quote endpoint returned HTTP 401 with the message "Please use an API key."

How much does the Finnhub API cost?

Finnhub's paid plans start at $49.99 a month for US market data and $50 a month per market for fundamentals, per its pricing pages on November 18, 2026. Fundamentals reach $200 a month per market, market data $199.99, and the All-in-One plan costs $3,500 a month billed annually. Commercial use needs an Enterprise plan with custom pricing.

Finnhub sells data in separate products, which is why its pricing looks confusing at first. The main pricing page shows only Free and All-in-One.

The cheaper plans sit on their own pages:

PlanPriceBilledRate limit
Free$060 calls a minute
Market Data Basic$49.99/moQuarterly150 a minute
Market Data Standard$129.99/moQuarterly300 a minute
Market Data Professional$199.99/moAnnually900 a minute
Fundamental-1$50/mo per marketQuarterly300 a minute
Fundamental-2$200/mo per marketAnnually300 a minute
All-in-One$3,500/moAnnually900 market, 300 fundamental
EnterpriseContact salesUnlimited

Watch the billing column. A $50 Fundamental-1 plan is charged quarterly, so the first bill is $150.

And "per market" means each exchange is a separate subscription. US fundamentals and UK fundamentals would be two plans.

Finnhub API plans and prices
Fundamentals are priced per market, and most plans bill quarterly or annually.

What does the Finnhub free tier include?

Finnhub's free tier includes 60 API calls a minute and 29 of its 118 documented endpoints: real-time quotes, a websocket stream for 50 symbols, a basic company profile, one year of company news, basic financials, insider transactions, as-reported financials, SEC filings, recommendation trends and earnings calendars. It also includes Senate lobbying, USA Spending, patent and visa data.

The free endpoints, from the docs, grouped:

That's a useful free tier for a dashboard or a learning project. Real-time quotes alone make it a favorite in tutorials.

There's also a hard cap on top of every plan: 30 API calls per second, per the docs' limits section. Go over either limit and you get HTTP 429.

Finnhub API rate limits by plan
A 30 calls per second cap sits on top of every plan.

Which Finnhub endpoints are premium?

On November 18, 2026, Finnhub's docs tagged 89 of 118 endpoints Premium. They include historical price candles (OHLCV), standardized financial statements, dividends, company ownership and 13F data, all estimates and price targets, earnings call transcripts, ETFs and mutual funds, congressional trading, technical indicators and global filings search. The full company profile is premium too.

The candles are the one that surprises people. The free tier has the latest quote, but not the price history you'd chart.

That limit isn't new. In a 2020 GitHub notice, Finnhub told users the free plan would be limited to 1 year of intraday price data and that the company profile endpoint was moving to premium.

Today's pricing table shows no historical OHLC on the free plan at all. If you're building a backtest, budget for a paid plan from the start.

Standardized statements follow the same pattern. Free users get financials "as reported," with line items named however each company named them. Comparing companies needs the standardized version, which starts at Fundamental-1.

Finnhub free and premium endpoints by section
Most of the free endpoints are company fundamentals.

How do you handle Finnhub API errors in Python?

Handle three cases: HTTP 401 or 403 means a missing key, a bad key, or a premium endpoint your plan doesn't cover, so stop and report it. HTTP 429 means you went over your per-minute or 30-per-second limit, so wait and retry. Anything else, raise. A short wrapper around requests covers all three.

Here's the wrapper I use. It sends the key in the X-Finnhub-Token header, so the key stays out of URLs and server logs:

import time, requests

API_KEY = ""   # your free key from the Finnhub dashboard

def finnhub(path, **params):
    for attempt in range(3):
        r = requests.get("https://finnhub.io/api/v1/" + path, params=params,
                         headers={"X-Finnhub-Token": API_KEY}, timeout=30)
        if r.status_code == 429:          # over your plan limit or 30/sec: wait and retry
            time.sleep(2 ** attempt)
            continue
        if r.status_code in (401, 403):   # no key, bad key, or a premium endpoint
            raise RuntimeError(f"Finnhub {r.status_code}: {r.text[:120]}")
        r.raise_for_status()
        return r.json()
    raise RuntimeError("Finnhub: still rate limited after 3 tries")

print(finnhub("quote", symbol="AAPL"))

I ran it with the key left empty, since I didn't open a Finnhub account for this post. It printed Finnhub 401: {"error":"Please use an API key."}, which is the path you'll hit on day one if an environment variable didn't load. I haven't tested the 403 or 429 branches against a live key, so treat those as based on Finnhub's documentation, not my own runs.

Two habits help on the free tier. Cache anything that doesn't change often, like company profiles and basic financials, so you aren't spending your 60 calls a minute on repeats. And if you poll quotes for many symbols, use the websocket instead; it streams trades for up to 50 symbols without counting each update as a call.

Finnhub API response codes and how to handle them
Stop on 401 and 403, wait and retry on 429.
Try it on real data. Twenty years of Apple's statements, from SEC filings:
curl -H "X-API-Key: edgr_your_key" "https://api.edgrapi.com/v1/fundamentals/AAPL?limit=20"
Get a free API key  50 free credits, no card.

How deep is Finnhub's fundamental data?

Finnhub's standardized financial statements cover 10 years and 40 quarters on the $50-a-month Fundamental-1 plan, and 30+ years annually and quarterly on the $200 Fundamental-2 plan, per its fundamentals pricing page. Free users get financials as reported from SEC filings instead. Dividends follow the same split: 10 years on Fundamental-1, 30 years on Fundamental-2.

Ten years is enough for most screens and valuation models. Thirty years matters for backtests across several market cycles.

The free as-reported data is still worth knowing about. It's built from the same SEC filings, and Finnhub even publishes an SEC financials-as-reported dataset on Kaggle for bulk download.

If you mainly need US fundamentals from SEC filings, compare that against what the SEC gives away. My best financial data APIs post tests history depth across nine providers.

Can you use Finnhub commercially?

Only on an Enterprise plan. Every Finnhub plan on its pricing pages, from Free through All-in-One at $3,500 a month, is labeled "Personal Use. Terms apply." Its Startups and Enterprise page is the one that offers commercial use with redistribution rights and unlimited API calls, at custom pricing through its sales team.

That's the biggest thing to check before you build. A $129.99 market data plan powering a public app would be outside its license.

Finnhub isn't unusual here. Alpha Vantage, Massive and Financial Datasets also label their cheaper plans personal or individual use.

What is unusual is how high the jump is. There's no published commercial plan between $0 and a sales call.

Does Finnhub have an MCP server?

Yes. Finnhub's documentation says its MCP server is available within ChatGPT, Claude and Gemini Enterprise, so AI assistants in those products can call Finnhub data as tools. The setup instructions are linked from its docs. Plan on each tool call being an API call against your plan, and on premium endpoints still needing a premium plan.

That last point matters for agents. An agent asked for a stock's price history will call the candles endpoint, which is premium.

So test your agent's common questions against the free tier before assuming it works. My roundup of MCP servers for financial data compares the options.

How does Finnhub compare to Alpha Vantage and FMP?

Finnhub has the most generous free rate limit of the three, at 60 calls a minute against Alpha Vantage's 25 requests a day and FMP's 250 calls a day. FMP has the cheapest paid entry at $29 a month and includes 5 years of statements free. Alpha Vantage's free key returns the latest 100 days of daily prices, while its full 25+ year history needs a premium key.

Here are the four providers side by side, from each one's pricing page in November 2026:

FinnhubAlpha VantageFMPEdgrapi
Free limit60 calls/min25 requests/day250 calls/day50 credits, once
Cheapest paid plan$49.99/mo, billed quarterly$49.99/mo$29/mo$10/mo
Free price historyNoLatest 100 daysNot checkedNo prices
Free fundamentalsAs reportedYes5 yearsSEC filings data
Commercial useEnterprise, by quoteWritten agreementSeparate commercial plansPublic SEC and federal data

The rate limit column hides a real difference. Sixty calls a minute adds up to far more than 250 calls a day if your app runs all day. But a limit is only useful if the endpoints you need are free, and on Finnhub most aren't.

So the choice usually comes down to which data you need first.

Live quotes and news on a hobby dashboard point to Finnhub. Price history for a backtest points to a paid plan somewhere, since none of these free tiers gives you years of candles. Comparable fundamentals for a screener point to FMP.

When should you use a Finnhub alternative?

Use a Finnhub alternative when you need a commercial license without a sales call, some free price history, or SEC-sourced data with deeper free access. Financial Modeling Prep's free plan allows 250 calls a day with 5 years of statements. Alpha Vantage gives 25 free requests a day, with the latest 100 days of daily prices. For SEC filings, congress trades and federal data on one key, Edgrapi fits.

My picks by gap:

To be fair to Finnhub, its free tier includes Senate lobbying and USA Spending data. Those overlap with what I sell, and on Finnhub they cost nothing.

Where Edgrapi differs is depth on the SEC and government side: 13F holdings, filings text, Form 144 and Form D, plus SAM.gov contract data, as REST and 23 MCP tools. It has no stock prices.

I've written up Alpha Vantage's pricing and FMP's pricing the same way.

When to use Finnhub or an alternative
Pick by the data you need first.

Start on the free tier, then check the license

Get a free Finnhub key, list the five endpoints your project actually calls, and check each one against the Premium tags in the docs before you write code. If any are premium, price the smallest plan that covers them, remembering quarterly billing and per-market fees. If anyone besides you will see the data, ask Finnhub about Enterprise first.

Frequently asked questions

Is the Finnhub API free?

Partly. Finnhub's free plan allows 60 API calls a minute and covers 29 of its 118 documented endpoints, including real-time quotes, basic financials, insider transactions, SEC filings and company news for one year. Historical price candles, standardized financial statements, estimates and ownership data need a paid plan. The free plan is for personal use only.

How much does Finnhub cost?

Finnhub's paid plans start at $49.99 a month for US market data, billed quarterly, and $50 a month per market for fundamentals, also billed quarterly. Market data tops out at $199.99 and fundamentals at $200 per market. The All-in-One plan costs $3,500 a month billed annually, and commercial Enterprise plans are priced by quote.

What are Finnhub's API limits?

Finnhub's free plan allows 60 API calls a minute. Paid plans raise that to 150 to 900 calls a minute depending on the plan, and Enterprise is unlimited. On top of every plan there's a cap of 30 calls per second. Exceeding a limit returns HTTP 429, per Finnhub's documentation.

How do I get a Finnhub API key?

Register for a free account on finnhub.io, and your API key appears in your dashboard. Send it with each request as the token URL parameter or in an X-Finnhub-Token header. A request without a key returns HTTP 401 with the message "Please use an API key," which I confirmed in November 2026.

Can I use Finnhub for commercial use?

Only on Finnhub's Enterprise plan. Every self-serve plan, from Free to the $3,500 All-in-One, is labeled personal use on its pricing pages. Finnhub's Startups and Enterprise page offers commercial use and redistribution rights with unlimited API calls, at custom pricing through its sales team.

What is the best alternative to Finnhub?

It depends on the gap. For a bigger free tier, Financial Modeling Prep allows 250 calls a day. For recent daily prices on a free key, Alpha Vantage. For SEC filings, 13F holdings, congressional trades and federal contracts on one key, Edgrapi. Check each provider's license if your product will show data to other people.

Related guides: Financial data APIs compared

Get a free API key