Finnhub API Documentation
Finnhub provides a REST API and WebSocket feed for financial market data. This package covers the complete endpoint catalog plus Python SDK usage patterns.
Quick Reference
| File | Title | Description |
|---|---|---|
contents/endpoints/default-api.md | DefaultApi — Endpoint Catalog | OpenAPI-generated table of all ~100 endpoints: HTTP method, URL path (/stock/candle, /forex/rates, etc.), and parameter list. Start here for any question about what endpoint exists or what parameters it accepts. All URIs are relative to https://finnhub.io/api/v1. |
contents/usage/python-readme.md | Python SDK README | Installation (pip install finnhub-python), client setup (finnhub.Client(api_key=...)), and per-endpoint Python method calls. Maps endpoint names to SDK methods. |
contents/usage/python-examples.py | Python Examples | Executable script with 30+ real finnhub_client.* calls covering stocks, bonds, ESG, congressional trading, market status, earnings estimates, and alternative data. Use as a call-signature reference. |
When to Use
Use this skill when the user asks about:
- Real-time and historical stock prices, candles, quotes (
/stock/candle,/quote) - Forex and crypto rates (
/forex/rates,/crypto/candle) - Company fundamentals: profile, financials, earnings, EPS/revenue/EBIT estimates
- News and sentiment: company news, market news, news sentiment scores
- ETF and mutual fund holdings and profile data
- Economic data: economic calendar, economic indicators
- Alternative data: insider transactions, congressional trading, supply-chain relationships
- ESG scores (current and historical)
- WebSocket real-time trades feed
- Bond price, tick, profile, and yield curve data
- Technical indicators and aggregate signals
- Market status, market holidays, earnings call schedules
How to Find Information
- For any endpoint question — read
contents/endpoints/default-api.md. The summary table at the top lists every endpoint with its HTTP method, URL path, and a link to full parameter details lower in the file. - For Python call signatures — read
contents/usage/python-readme.mdfor the common methods, orcontents/usage/python-examples.pyfor concrete working calls. - Endpoint-to-method mapping — the Python method name mirrors the endpoint name in snake_case (e.g.
CompanyEarnings→finnhub_client.company_earnings()).

