Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

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.

Docs

Finnhub's own pages, linked as published.

Its OpenAPI document: 116 operations and rate limits
Official specSwagger 2.0 · 116 operations Spec (YAML)Provider's spec
Operations in the finnhub spec
MethodPathSummaryParamsSource
GET/searchSymbol Lookup2Spec
GET/stock/symbolStock Symbol4Spec
GET/stock/market-statusMarket Status1Spec
GET/stock/market-holidayMarket Holiday1Spec
GET/stock/profileCompany Profile3Spec
GET/stock/profile2Company Profile 23Spec
GET/stock/executiveCompany Executive1Spec
GET/newsMarket News2Spec
GET/company-newsCompany News3Spec
GET/press-releasesMajor Press Releases3Spec
GET/news-sentimentNews Sentiment1Spec
GET/stock/peersPeers2Spec
GET/stock/metricBasic Financials2Spec
GET/stock/price-metricPrice Metrics1Spec
GET/ca/symbol-changeSymbol Change2Spec
GET/ca/isin-changeISIN Change2Spec
GET/stock/historical-market-capHistorical Market Cap3Spec
GET/stock/historical-employee-countHistorical Employee Count3Spec
GET/institutional/profileInstitutional Profile1Spec
GET/institutional/portfolioInstitutional Portfolio3Spec
GET/institutional/ownershipInstitutional Ownership4Spec
GET/stock/ownershipOwnership2Spec
GET/stock/fund-ownershipFund Ownership2Spec
GET/stock/insider-transactionsInsider Transactions3Spec
GET/stock/insider-sentimentInsider Sentiment3Spec
GET/stock/financialsFinancial Statements4Spec
GET/stock/financials-reportedFinancials As Reported6Spec
GET/stock/revenue-breakdownRevenue Breakdown2Spec
GET/stock/filingsSEC Filings6Spec
GET/stock/filings-sentimentSEC Sentiment Analysis1Spec
GET/stock/similarity-indexSimilarity Index3Spec
GET/calendar/ipoIPO Calendar2Spec
GET/sector/metricsSector Metrics1Spec
GET/stock/dividendDividends3Spec
GET/stock/recommendationRecommendation Trends1Spec
GET/stock/price-targetPrice Target1Spec
GET/stock/upgrade-downgradeStock Upgrade/Downgrade3Spec
GET/stock/revenue-estimateRevenue Estimates2Spec
GET/stock/ebitda-estimateEBITDA Estimates2Spec
GET/stock/ebit-estimateEBIT Estimates2Spec

Showing 40 of 116 operations; the full list is in the spec.

Rate limits

Published rate limits for finnhub
LimitScopePlanEndpointBurst / concurrency
30 / secondkeyAllAll— / —

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)