---
id: finnhub-python
version: "2.4.29"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# finnhub-python — Finnhub API

License: permissive · Maintenance: active · Downloads: 469.8K/mo

## What it is and what it does

Finnhub-python wraps the Finnhub Stock API into a Python client that lets you query financial market data programmatically. It covers stocks, forex, crypto, ETFs, mutual funds, bonds, and economic indicators—returning raw JSON responses that you can process directly or convert to pandas DataFrames. The library is thin and straightforward: you instantiate a Client with an API key, then call methods like stock_candles(), company_profile(), or quote() to fetch data.

The package depends only on requests for HTTP calls, making it lightweight to install. It's actively maintained and popular, suggesting it's a stable choice for developers building financial data pipelines, analysis tools, or trading applications that need real-time or historical market information.

Use it for:

- Fetch real-time stock quotes and historical candle data for charting or analysis
- Build a financial dashboard that displays company fundamentals, earnings, and news
- Analyze technical indicators and price patterns for trading signals or backtesting
- Retrieve company profile, executive, and peer data for due diligence or research
- Monitor crypto and forex rates and candle data for multi-asset portfolio tracking

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Finnhub-python is a client library for the Finnhub Stock API, providing access to financial market data including stock quotes, company fundamentals, earnings, technical indicators, and news.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and offers a broad API surface for financial data access. It's stable enough for production use. Verify that you have a valid API key and understand rate limits for your use case.

## Install

pip install finnhub-python
uv add finnhub-python
poetry add finnhub-python

## Installing finnhub-python

Before you install: Installation is straightforward with low friction—the package is a pure Python wheel with only requests as a runtime dependency. Active maintenance status indicates ongoing support.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions; you must include a copy of the license and note any modifications.

Quickstart:

pip install finnhub-python

import finnhub

finnhub_client = finnhub.Client(api_key="YOUR_API_KEY")
res = finnhub_client.quote('AAPL')
print(res)

Requires a valid Finnhub API key

Verify before relying:

- Whether the package requires a Finnhub API key and what rate limits apply to free vs. paid tiers
- Minimum Python version requirement (not specified in metadata)
- Whether all API endpoints documented in the excerpt are fully implemented and current

## Package facts

- License: Apache-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 469.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stock market api client, financial data python library, stock quotes and fundamentals, finnhub api wrapper, market data integration, earnings and technical indicators, company financial information, financial-data, api-client, market-data

[View on SkillFed](https://skillfed.io/packages/finnhub-python) · [View on PyPI](https://pypi.org/project/finnhub-python/)