
Finnhub API
finnhub.io
Stock, fundamentals and alternative data API: company profiles, financials as reported, SEC and global filings.
What it does
Finnhub's REST API (Swagger 2.0 spec published) covers company profiles, peers, basic and as-reported financials, SEC and international filings, global filings search, fund ownership and market data. API key via the token query parameter; a 30 API calls per second cap applies on top of every plan's limit.
In its API docs
Docs
Finnhub's own pages, linked as published.
- API referencefinnhub.io/docs/api
- OpenAPI specfinnhub.io/static/swagger.json
- PricingThrough sales only
- Rate limitsfinnhub.io/docs/api/rate-limit
- Websitefinnhub.io
Its OpenAPI document: 116 operations and rate limits
| Method | Path | Summary | Params | Source |
|---|---|---|---|---|
| GET | /search | Symbol Lookup | 2 | Spec |
| GET | /stock/symbol | Stock Symbol | 4 | Spec |
| GET | /stock/market-status | Market Status | 1 | Spec |
| GET | /stock/market-holiday | Market Holiday | 1 | Spec |
| GET | /stock/profile | Company Profile | 3 | Spec |
| GET | /stock/profile2 | Company Profile 2 | 3 | Spec |
| GET | /stock/executive | Company Executive | 1 | Spec |
| GET | /news | Market News | 2 | Spec |
| GET | /company-news | Company News | 3 | Spec |
| GET | /press-releases | Major Press Releases | 3 | Spec |
| GET | /news-sentiment | News Sentiment | 1 | Spec |
| GET | /stock/peers | Peers | 2 | Spec |
| GET | /stock/metric | Basic Financials | 2 | Spec |
| GET | /stock/price-metric | Price Metrics | 1 | Spec |
| GET | /ca/symbol-change | Symbol Change | 2 | Spec |
| GET | /ca/isin-change | ISIN Change | 2 | Spec |
| GET | /stock/historical-market-cap | Historical Market Cap | 3 | Spec |
| GET | /stock/historical-employee-count | Historical Employee Count | 3 | Spec |
| GET | /institutional/profile | Institutional Profile | 1 | Spec |
| GET | /institutional/portfolio | Institutional Portfolio | 3 | Spec |
| GET | /institutional/ownership | Institutional Ownership | 4 | Spec |
| GET | /stock/ownership | Ownership | 2 | Spec |
| GET | /stock/fund-ownership | Fund Ownership | 2 | Spec |
| GET | /stock/insider-transactions | Insider Transactions | 3 | Spec |
| GET | /stock/insider-sentiment | Insider Sentiment | 3 | Spec |
| GET | /stock/financials | Financial Statements | 4 | Spec |
| GET | /stock/financials-reported | Financials As Reported | 6 | Spec |
| GET | /stock/revenue-breakdown | Revenue Breakdown | 2 | Spec |
| GET | /stock/filings | SEC Filings | 6 | Spec |
| GET | /stock/filings-sentiment | SEC Sentiment Analysis | 1 | Spec |
| GET | /stock/similarity-index | Similarity Index | 3 | Spec |
| GET | /calendar/ipo | IPO Calendar | 2 | Spec |
| GET | /sector/metrics | Sector Metrics | 1 | Spec |
| GET | /stock/dividend | Dividends | 3 | Spec |
| GET | /stock/recommendation | Recommendation Trends | 1 | Spec |
| GET | /stock/price-target | Price Target | 1 | Spec |
| GET | /stock/upgrade-downgrade | Stock Upgrade/Downgrade | 3 | Spec |
| GET | /stock/revenue-estimate | Revenue Estimates | 2 | Spec |
| GET | /stock/ebitda-estimate | EBITDA Estimates | 2 | Spec |
| GET | /stock/ebit-estimate | EBIT Estimates | 2 | Spec |
Showing 40 of 116 operations; the full list is in the spec.
Rate limits
| Limit | Scope | Plan | Endpoint | Burst / concurrency |
|---|---|---|---|---|
| 30 / second | key | All | All | — / — |
On 429: Status code 429 when the limit is exceeded. GridRouter never paces above these and backs off on 429, honoring Retry-After. Source, checked Sep 29, 2026
Sources for this page (2)
- Finnhub API Swaggerchecked Sep 29, 2026
- Finnhub API documentationchecked Sep 29, 2026