Finance — entry 018 of 47
Finnhub
Finnhub is a market-data platform built by ex-Google, Bloomberg, and Tradeweb engineers, offering realtime stock quotes across 60+ global exchanges plus forex, crypto, company fundamentals, earnings calendars, SEC filings, and sentiment data over REST and WebSocket. Its free tier is notably generous at 60 API calls/minute with WebSocket streaming for up to 50 symbols, requiring only a free API-key signup; paid tiers ($11.99–$99.99/month) unlock international stocks, deeper financials, and higher rate limits.
AuthenticationAPI KeySign up with the provider to obtain credentials.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreemiumA usable free tier exists, with paid plans for more volume.
FormatsJSON, WebSocketResponses can be requested as JSON or WebSocket.
GreatAPIs Score
Score87
Authentication15/25API key required
Pricing17/20Freemium tier available
Docs20/20Machine-readable spec file bundled
Formats15/15Supports 2 response formats
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/finnhub/"><img src="https://greatapis.com/badge/finnhub.svg" alt="Scored 87 on greatapis.com"></a>Auth quickstart
- Get a key at the provider
- Send it on every request as a query param
?token=<key>
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
Default117
POST/ai-chatAI Copilot
Request body
application/json — AIChatBody
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | AIChatResponse |
GET/airline/price-indexAirline Price Index
Parameters
| Name | In | Required | Type |
|---|---|---|---|
airline | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | AirlinePriceIndexData |
GET/bank-branchBank Branch List
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | — |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | BankBranchRes |
GET/bond/priceBond price data
Parameters
| Name | In | Required | Type |
|---|---|---|---|
isin | query | yes | string |
from | query | yes | integer |
to | query | yes | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | BondCandles |
GET/bond/profileBond Profile
Parameters
| Name | In | Required | Type |
|---|---|---|---|
isin | query | no | string |
cusip | query | no | string |
figi | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | BondProfile |
GET/bond/tickBond Tick Data
Parameters
| Name | In | Required | Type |
|---|---|---|---|
isin | query | yes | string |
date | query | yes | string |
limit | query | yes | integer |
skip | query | yes | integer |
exchange | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | BondTickData |
GET/bond/yield-curveBond Yield Curve
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | BondYieldCurve |
GET/ca/isin-changeISIN Change
Parameters
| Name | In | Required | Type |
|---|---|---|---|
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | IsinChange |
GET/ca/symbol-changeSymbol Change
Parameters
| Name | In | Required | Type |
|---|---|---|---|
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SymbolChange |
GET/calendar/earningsEarnings Calendar
Parameters
| Name | In | Required | Type |
|---|---|---|---|
from | query | no | string |
to | query | no | string |
symbol | query | no | string |
international | query | no | boolean |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EarningsCalendar |
GET/calendar/economicEconomic Calendar
Parameters
| Name | In | Required | Type |
|---|---|---|---|
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EconomicCalendar |
GET/calendar/ipoIPO Calendar
Parameters
| Name | In | Required | Type |
|---|---|---|---|
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | IPOCalendar |
GET/company-newsCompany News
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/countryCountry Metadata
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/covid19/usCOVID-19
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/crypto/candleCrypto Candles
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
from | query | yes | integer |
to | query | yes | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CryptoCandles |
GET/crypto/exchangeCrypto Exchanges
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/crypto/profileCrypto Profile
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CryptoProfile |
GET/crypto/symbolCrypto Symbol
Parameters
| Name | In | Required | Type |
|---|---|---|---|
exchange | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/economicEconomic Data
Parameters
| Name | In | Required | Type |
|---|---|---|---|
code | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EconomicData |
GET/economic/codeEconomic Code
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/etf/allocationETFs Equity Allocation
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | ETFsAllocation |
GET/etf/countryETFs Country Exposure
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | ETFsCountryExposure |
GET/etf/holdingsETFs Holdings
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
skip | query | no | integer |
date | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | ETFsHoldings |
GET/etf/profileETFs Profile
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | ETFsProfile |
GET/etf/sectorETFs Sector Exposure
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | ETFsSectorExposure |
GET/fda-advisory-committee-calendarFDA Committee Meeting Calendar
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/forex/candleForex Candles
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
from | query | yes | integer |
to | query | yes | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | ForexCandles |
GET/forex/exchangeForex Exchanges
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/forex/ratesForex rates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
base | query | no | string |
date | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | Forexrates |
GET/forex/symbolForex Symbol
Parameters
| Name | In | Required | Type |
|---|---|---|---|
exchange | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/global-filings/downloadDownload Filings
Parameters
| Name | In | Required | Type |
|---|---|---|---|
documentId | query | yes | string |
GET/global-filings/filterSearch Filter
Parameters
| Name | In | Required | Type |
|---|---|---|---|
field | query | yes | string |
source | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SearchFilter |
POST/global-filings/searchGlobal Filings Search
Request body
application/json — SearchBody
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SearchResponse |
POST/global-filings/search-in-filingSearch In Filing
Request body
application/json — InFilingSearchBody
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InFilingResponse |
GET/index/constituentsIndices Constituents
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | IndicesConstituents |
GET/index/historical-constituentsIndices Historical Constituents
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | IndicesHistoricalConstituents |
GET/indicatorTechnical Indicators
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
from | query | yes | integer |
to | query | yes | integer |
indicator | query | yes | string |
Request body
application/json — IndicatorFields
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | TechnicalIndicator |
GET/institutional/ownershipInstitutional Ownership
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
cusip | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InstitutionalOwnership |
GET/institutional/portfolioInstitutional Portfolio
Parameters
| Name | In | Required | Type |
|---|---|---|---|
cik | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InstitutionalPortfolio |
GET/institutional/profileInstitutional Profile
Parameters
| Name | In | Required | Type |
|---|---|---|---|
cik | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InstitutionalProfile |
GET/mutual-fund/countryMutual Funds Country Exposure
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MutualFundCountryExposure |
GET/mutual-fund/eetMutual Funds EET
Parameters
| Name | In | Required | Type |
|---|---|---|---|
isin | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MutualFundEet |
GET/mutual-fund/eet-paiMutual Funds EET PAI
Parameters
| Name | In | Required | Type |
|---|---|---|---|
isin | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MutualFundEetPai |
GET/mutual-fund/holdingsMutual Funds Holdings
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
skip | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MutualFundHoldings |
GET/mutual-fund/profileMutual Funds Profile
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MutualFundProfile |
GET/mutual-fund/sectorMutual Funds Sector Exposure
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MutualFundSectorExposure |
GET/newsMarket News
Parameters
| Name | In | Required | Type |
|---|---|---|---|
category | query | yes | string |
minId | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/news-sentimentNews Sentiment
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | NewsSentiment |
GET/press-releasesMajor Press Releases
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | PressRelease |
GET/quoteQuote
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | Quote |
GET/scan/patternPattern Recognition
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | PatternRecognition |
GET/scan/support-resistanceSupport/Resistance
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SupportResistance |
GET/scan/technical-indicatorAggregate Indicators
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | AggregateIndicators |
GET/searchSymbol Lookup
Parameters
| Name | In | Required | Type |
|---|---|---|---|
q | query | yes | string |
exchange | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SymbolLookup |
GET/sector/metricsSector Metrics
Parameters
| Name | In | Required | Type |
|---|---|---|---|
region | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SectorMetric |
GET/stock/bboHistorical NBBO
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
date | query | yes | string |
limit | query | yes | integer |
skip | query | yes | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | HistoricalNBBO |
GET/stock/bidaskLast Bid-Ask
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | LastBid-Ask |
GET/stock/candleStock Candles
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
resolution | query | yes | string |
from | query | yes | integer |
to | query | yes | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | StockCandles |
GET/stock/capex-estimateCapex Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CapexEstimates |
GET/stock/congressional-tradingCongressional Trading
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CongressionalTrading |
GET/stock/dividendDividends
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/dividend2Dividends 2 (Basic)
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | Dividends2 |
GET/stock/dps-estimateDPS Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | DpsEstimates |
GET/stock/earningsEarnings Surprises
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/earnings-call-liveEarnings Call Audio Live
Parameters
| Name | In | Required | Type |
|---|---|---|---|
from | query | no | string |
to | query | no | string |
symbol | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EarningsCallLive |
GET/stock/earnings-quality-scoreCompany Earnings Quality Score
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CompanyEarningsQualityScore |
GET/stock/ebit-estimateEBIT Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EbitEstimates |
GET/stock/ebitda-estimateEBITDA Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EbitdaEstimates |
GET/stock/eps-estimateEarnings Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EarningsEstimates |
GET/stock/esgCompany ESG Scores
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CompanyESG |
GET/stock/executiveCompany Executive
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CompanyExecutive |
GET/stock/fcf-estimateFCF Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | FcfEstimates |
GET/stock/filingsSEC Filings
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
cik | query | no | string |
accessNumber | query | no | string |
form | query | no | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/filings-sentimentSEC Sentiment Analysis
Parameters
| Name | In | Required | Type |
|---|---|---|---|
accessNumber | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SECSentimentAnalysis |
GET/stock/financialsFinancial Statements
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
statement | query | yes | string |
freq | query | yes | string |
preliminary | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | FinancialStatements |
GET/stock/financials-reportedFinancials As Reported
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
cik | query | no | string |
accessNumber | query | no | string |
freq | query | no | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | FinancialsAsReported |
GET/stock/fund-ownershipFund Ownership
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | FundOwnership |
GET/stock/gross-income-estimateGross Income Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | GrossIncomeEstimates |
GET/stock/historical-employee-countHistorical Employee Count
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | HistoricalEmployeeCount |
GET/stock/historical-esgHistorical ESG Scores
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | HistoricalCompanyESG |
GET/stock/historical-market-capHistorical Market Cap
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | HistoricalMarketCapData |
GET/stock/insider-sentimentInsider Sentiment
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InsiderSentiments |
GET/stock/insider-transactionsInsider Transactions
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InsiderTransactions |
GET/stock/international-filingsInternational Filings
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
country | query | no | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/investment-themeInvestment Themes (Thematic Investing)
Parameters
| Name | In | Required | Type |
|---|---|---|---|
theme | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | InvestmentThemes |
GET/stock/lobbyingSenate Lobbying
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | LobbyingResult |
GET/stock/market-holidayMarket Holiday
Parameters
| Name | In | Required | Type |
|---|---|---|---|
exchange | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MarketHoliday |
GET/stock/market-statusMarket Status
Parameters
| Name | In | Required | Type |
|---|---|---|---|
exchange | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | MarketStatus |
GET/stock/metricBasic Financials
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
metric | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | BasicFinancials |
GET/stock/net-income-estimateNet Income Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | NetIncomeEstimates |
GET/stock/newsroomNewsroom
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | Newsroom |
GET/stock/ocf-estimateOCF Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | OcfEstimates |
GET/stock/ownershipOwnership
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
limit | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | Ownership |
GET/stock/peersPeers
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
grouping | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/presentationCompany Presentation
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | StockPresentation |
GET/stock/pretax-income-estimatePretax Income Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | PretaxIncomeEstimates |
GET/stock/price-metricPrice Metrics
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
date | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | PriceMetrics |
GET/stock/price-targetPrice Target
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | PriceTarget |
GET/stock/profileCompany Profile
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
cusip | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CompanyProfile |
GET/stock/profile2Company Profile 2
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
isin | query | no | string |
cusip | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | CompanyProfile2 |
GET/stock/recommendationRecommendation Trends
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/revenue-breakdownRevenue Breakdown
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
cik | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | RevenueBreakdown |
GET/stock/revenue-breakdown2Revenue Breakdown & KPI
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | RevenueBreakdown2 |
GET/stock/revenue-estimateRevenue Estimates
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | RevenueEstimates |
GET/stock/similarity-indexSimilarity Index
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
cik | query | no | string |
freq | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SimilarityIndex |
GET/stock/social-sentimentSocial Sentiment
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SocialSentiment |
GET/stock/splitSplits
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/supply-chainSupply Chain Relationships
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | SupplyChainRelationships |
GET/stock/symbolStock Symbol
Parameters
| Name | In | Required | Type |
|---|---|---|---|
exchange | query | yes | string |
mic | query | no | string |
securityType | query | no | string |
currency | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/tickTick Data
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
date | query | yes | string |
limit | query | yes | integer |
skip | query | yes | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | TickData |
GET/stock/transcriptsEarnings Call Transcripts
Parameters
| Name | In | Required | Type |
|---|---|---|---|
id | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EarningsCallTranscripts |
GET/stock/transcripts/listEarnings Call Transcripts List
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | EarningsCallTranscriptsList |
GET/stock/upgrade-downgradeStock Upgrade/Downgrade
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | no | string |
from | query | no | string |
to | query | no | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | — |
GET/stock/usa-spendingUSA Spending
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | UsaSpendingResult |
GET/stock/uspto-patentUSPTO Patents
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | UsptoPatentResult |
GET/stock/visa-applicationH1-B Visa Application
Parameters
| Name | In | Required | Type |
|---|---|---|---|
symbol | query | yes | string |
from | query | yes | string |
to | query | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | successful operation | VisaApplicationResult |
Try it
Developer reference
Base URL
https://finnhub.io/api/v1Rate limit
Finnhub's own docs (finnhub.io/docs/api/rate-limit) publish one blanket ceiling that applies across every plan: no more than 30 API calls per second. Exceeding a limit -- that ceiling or the per-plan quota assigned when a key is issued -- returns HTTP 429; exact per-plan calls-per-minute figures aren't published on the public docs site.
Key endpoints
- GET/quote
- GET/stock/symbol
- GET/stock/profile2
- GET/company-news
- GET/news