# Finnhub (slim)

> Finnhub is a market data API for stock quotes and candles, company fundamentals, estimates, filings, transcripts, news and alternative data, with forex, crypto and economic series. Agents call the REST API at finnhub.io/api/v1 or the hosted MCP server at mcp.finnhub.io.

- Full: https://www.anchorterminal.com/tools/finnhub.md (~6,950 tokens) · this version ~1,980 tokens · JSON https://www.anchorterminal.com/tools/finnhub.json · canonical https://www.anchorterminal.com/tools/finnhub
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-04 · pricing https://www.anchorterminal.com/tools/finnhub#pricing · reviews https://www.anchorterminal.com/tools/finnhub#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**E · 45.1/100 · rank #1140 of 1349 · #10 in Financial market data · not agent-ready · confidence low**


Assessment: A public Swagger document covers 116 endpoints, six official client libraries exist, and a free key gives 60 calls a minute with no card. The key is documented in the query string, no status page, changelog, error reference or privacy policy was found, and robots.txt kept the terms from our reader.

## Facts

- Kind: HTTP API · vendor: Finnhub · category: Financial market data · legal entity: Finnhub · provenance 45/100
- Endpoint: `https://finnhub.io/api/v1` (HTTP, Streamable HTTP, websocket)
- Auth: OAuth or key · pricing: Freemium · x402: no · licence: unknown
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The REST API at finnhub.io/api/v1 and the hosted MCP server at mcp.finnhub.io/mcp, read from the Swagger document, the docs page's embedded data, the pricing page's script data, the MCP connection page, the GitHub organisation and PyPI on 3 November 2026. No account was made and no tool was called
- Reader note: finnhub.io pages render by script. The docs page embeds the full API document as JSON and the pricing page embeds its prices, so both were read from the public HTML and bundle. robots.txt disallows /terms-of-service and /faq, which were not read
- API: 116 paths, 115 GET and one POST (/ai-chat), grouped as stock prices and candles, fundamentals and metrics, estimates, filings and transcripts, ownership, ETFs and funds, forex, crypto, bonds, economic data and alternative data. 87 operations carry a premium marker
- Rate limits: 60 calls a minute on the free key; 150, 300 and 900 a minute on market data plans; 900 market data and 300 fundamental calls a minute on All-In-One; a 30 calls a second limit on top of every plan; 429 when exceeded. Enterprise is unlimited per the pricing page
- MCP server: Streamable HTTP at mcp.finnhub.io/mcp with OAuth against the Finnhub account, 70 tools grouped by fundamentals, estimates, earnings and filings, funds, forex and crypto, economic and alternative data. An unauthenticated GET answers 401 with resource metadata. Needs a paid Claude or ChatGPT plan for custom connectors
- Real-time data: The quote endpoint is real time for US stocks per its description, with international real-time prices for enterprise clients through a partner feed. A websocket at ws.finnhub.io streams trades
- Errors: 401 with a JSON `error` field without a key in our one test call, and a documented 429 over the limit. No other error responses documented
- SDKs: finnhub-python 2.4.29 (24 June 2026, Apache-2.0), finnhub-go, finnhub-js, finnhub-ruby, finnhub-kotlin and finnhub-php, generated from the API document
- Use terms: Every self-serve plan is marked Personal Use with the terms applying; enterprise plans carry commercial use and redistribution rights. The terms themselves were not read because robots.txt disallows the page
- Legal entity: Not found. The GitHub organisation gives New York, NY, and the site names only Finnhub with sales, support and billing addresses at finnhub.io
- Prices: Market data Basic, 150 calls a minute $49.99 per month (plan); Market data Standard, 300 calls a minute $129.99 per month (plan); Market data Professional, 900 calls a minute $199.99 per month (plan); Fundamentals, plan 1 $50 per month (plan); All-In-One, 900 market data and 300 fundamental calls a minute $3500 per month (plan)

- Scores: Reliability 48, Performance pending, Schema & documentation 58, Agent ergonomics 56, Security & auth 32, Payments & pricing 30, Task success pending, Maintenance & community 60, Transparency & trust 27 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines. · Schema & documentation, A public Swagger 2.0 document covers 116 paths with a description on every operation, declaring the key as a query parameter and a 200 respo… · Agent ergonomics, The REST API is the surface graded. · Security & auth, One key per account with no scopes, documented as `token=` in the query string or an `X-Finnhub-Token` header, and the Swagger document decl… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Read as a closed service. · Transparency & trust, A closed service whose terms exist at a page that robots.txt disallows, so they were not read; the pricing page says every self-serve plan i…
- Sources: 13, open questions: 9, both in the full twin
- Capabilities: market.prices, market.fundamentals, market.news, market.filings, market.history, market.crypto, market.indices, data.markets, data.company
- JSON: https://www.anchorterminal.com/api/v1/tools/finnhub.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/finnhub.svg` or a link to https://www.anchorterminal.com/tools/finnhub from a page on finnhub.io or one of its subdomains, or the README at the root of github.com/Finnhub-Stock-API/finnhub-python, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: support@finnhub.io; https://finnhub.io/docs/api; https://finnhub.io/static/finnhub-how-to-connect-mcp-server.html; more in the full twin

## Before you call it

1. Send the key as the `X-Finnhub-Token` header, not as `token=` in the URL, and keep under 30 calls a second on top of the plan's per-minute limit
2. Check the `premium` marker before calling; a free key reaches 29 operations and the rest answer with an error
3. Poll /quote sparingly; the docs say constant polling is not recommended and point to the websocket for real-time updates
4. Expect 401 `{"error":"Please use an API key."}` without a key and 429 over the limit; wait a minute before retrying, as the MCP page advises
5. Self-serve plans are personal use; anything commercial needs the enterprise contact route

## Connect

```bash
pip install finnhub-python
```

```bash
curl -H "X-Finnhub-Token: $FINNHUB_API_KEY" "https://finnhub.io/api/v1/quote?symbol=AAPL"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/finnhub

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| EODHD | C | 59 | market.history, market.prices, market.fundamentals, market.filings, market.news, market.indices, market.crypto, data.markets, data.company | https://www.anchorterminal.com/tools/eodhd.min.md |
| Financial Modeling Prep | D | 48.7 | market.fundamentals, market.prices, market.history, market.filings, market.news, market.indices, market.crypto, data.company, data.markets | https://www.anchorterminal.com/tools/financial-modeling-prep.min.md |
| Twelve Data | BB | 70 | market.prices, market.history, market.fundamentals, market.crypto, market.indices, market.news, market.filings, data.markets | https://www.anchorterminal.com/tools/twelve-data.min.md |
| Financial Datasets | C | 61.8 | market.fundamentals, market.filings, market.prices, market.history, market.news, market.indices, data.markets, data.company | https://www.anchorterminal.com/tools/financial-datasets.min.md |
| Intrinio | C | 54.2 | market.prices, market.fundamentals, market.filings, market.news, market.history, market.indices, data.markets, data.company | https://www.anchorterminal.com/tools/intrinio.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)