finnhub-python

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 on this page — 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

finnhub-python on PyPI

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

Evidence: finnhub_python-2.4.29-py3-none-any.whl

Keywords: finnhub, Finnhub API, api

Tags

More WWW/HTTP packages