FinnhubApi
Types
Functions
Aggregate Indicators Get aggregate signal of multiple technical indicators such as MACD, RSI, Moving Average v.v. A full list of indicators can be found here.
Bond price data Get bond's price data. The following datasets are supported: Exchange Segment Delay US Government Bonds Government Bonds End-of-day FINRA Trace BTDS: US Corporate Bonds Delayed 4h FINRA Trace 144A Bonds Delayed 4h
Bond Profile Get general information of a bond. You can query by FIGI, ISIN or CUSIP
Bond Tick Data Get trade-level data for bonds. The following datasets are supported: Exchange Segment Delay FINRA Trace BTDS: US Corporate Bonds Delayed 4h FINRA Trace 144A Bonds Delayed 4h
Bond Yield Curve
Basic Financials Get company basic financials such as margin, P/E ratio, 52-week high/low etc.
Earnings Surprises Get company historical quarterly earnings surprise going back to 2000.
Company Earnings Quality Score This endpoint provides Earnings Quality Score for global companies. Earnings quality refers to the extent to which current earnings predict future earnings. \"High-quality\" earnings are expected to persist, while \"low-quality\" earnings do not. A higher score means a higher earnings quality. Finnhub uses a proprietary model which takes into consideration 4 criteria:
EBITDA Estimates Get company's ebitda estimates.
EBIT Estimates Get company's ebit estimates.
Earnings Estimates Get company's EPS estimates.
Company ESG Scores This endpoint provides ESG scores and important indicators for 1000+ global companies. The data is collected through company's public ESG disclosure and public sources. Our ESG scoring models takes into account more than 150 different inputs to calculate the level of ESG risks and how well a company is managing them. A higher score means lower ESG risk or better ESG management. ESG scores are in the the range of 0-100. Some key indicators might contain letter-grade score from C- to A+ with C- is the lowest score and A+ is the highest score.
Company Executive Get a list of company's executives and members of the Board.
Company News List latest company news by symbol. This endpoint is only available for North American companies.
Peers Get company peers. Return a list of peers operating in the same country and sector/industry.
Company Profile Get general information of a company. You can query by symbol, ISIN or CUSIP
Company Profile 2 Get general information of a company. You can query by symbol, ISIN or CUSIP. This is the free version of companyProfile.
Revenue Estimates Get company's revenue estimates.
Country Metadata List all countries and metadata.
Crypto Exchanges List supported crypto exchanges
Crypto Profile Get crypto's profile.
Crypto Symbol List supported crypto symbols by exchange
Earnings Calendar Get historical and coming earnings release. EPS and Revenue in this endpoint are non-GAAP, which means they are adjusted to exclude some one-time or unusual items. This is the same data investors usually react to and talked about on the media. Estimates are sourced from both sell-side and buy-side analysts.
Economic Calendar Get recent and upcoming economic releases.Historical events and surprises are available for Enterprise clients.
Economic Code List codes of supported economic data.
Economic Data Get economic data.
ETFs Country Exposure Get ETF country exposure data.
ETFs Holdings Get full ETF holdings/constituents. This endpoint has global coverage. Widget only shows top 10 holdings.
ETFs Profile Get ETF profile information. This endpoint has global coverage.
ETFs Sector Exposure Get ETF sector exposure data.
FDA Committee Meeting Calendar
SEC Filings List company's filing. Limit to 250 documents at a time. This data is available for bulk download on here(https://www.kaggle.com/finnhub/sec-filings>Kaggle SEC Filings database).
SEC Sentiment Analysis Get sentiment analysis of 10-K and 10-Q filings from SEC. An abnormal increase in the number of positive/negative words in filings can signal a significant change in the company's stock price in the upcoming 4 quarters. We make use of Loughran and McDonald Sentiment Word Lists to calculate the sentiment for each filing.
Financial Statements Get standardized balance sheet, income statement and cash flow for global companies going back 30+ years. Data is sourced from original filings most of which made available through filings and internationalFilings endpoints.Wondering why our standardized data is different from Bloomberg, Reuters, Factset, S&P or Yahoo Finance ? Check out our here to learn more.
Financials As Reported Get financials as reported. This data is available for bulk download on Kaggle SEC Financials database.
Forex Exchanges List supported forex exchanges
Forex rates Get rates for all forex pairs. Ideal for currency conversion
Forex Symbol List supported forex symbols.
Fund Ownership Get a full list fund and institutional investors of a company in descending order of the number of shares held. Data is sourced from 13F form, Schedule 13D and 13G for US market, UK Share Register for UK market, SEDI for Canadian market and equivalent filings for other international markets.
Global Filings Search Search for best-matched filings across global companies' filings, transcripts and press releases. You can filter by anything from symbol, ISIN to form type, and document sources.This endpoint will return a list of documents that match your search criteria. If you would like to get the excerpts as well, please set highlighted to true. Once you have the list of documents, you can get a list of excerpts and positions to highlight the document using the searchInFiling endpoint. This endpoint is powered by here
Search Filter
Indices Constituents Get a list of index's constituents. A list of supported indices for this endpoint can be found here.
Indices Historical Constituents Get full history of index's constituents including symbols and dates of joining and leaving the Index. Currently support ^GSPC, ^NDX, ^DJI
Insider Sentiment
Insider Transactions Company insider transactions data sourced from Form 3,4,5, SEDI and relevant companies' filings. This endpoint covers US, Canada, Australia, and selected EU companies. Limit to 100 transactions per API call.
Institutional Ownership Get a list institutional investors' positions for a particular stock overtime. Data from 13-F filings. Limit to 1 year of data at a time.
Institutional Portfolio Get the holdings/portfolio data of institutional investors from 13-F filings. Limit to 1 year of data at a time. You can get a list of supported CIK /api/v1/institutional/list?token=.
Institutional Profile Get a list of well-known institutional investors. Currently support 60+ profiles.
International Filings
Investment Themes (Thematic Investing).
IPO Calendar. Get recent and upcoming IPO.
ISIN Change Get a list of ISIN changes for EU-listed securities. Limit to 2000 events at a time.
Market News Get latest market news.
Mutual Funds Country Exposure Get Mutual Funds country exposure data.
Mutual Funds EET Get EET data for EU funds. For PAIs data, please see the EET PAI endpoint.
Mutual Funds EET PAI Get EET PAI data for EU funds.
Mutual Funds Holdings Get full Mutual Funds holdings/constituents. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN.
Mutual Funds Profile Get mutual funds profile information. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN.
Mutual Funds Sector Exposure Get Mutual Funds sector exposure data.
News Sentiment Get company's news sentiment and statistics. This endpoint is only available for US companies.
Ownership Get a full list of shareholders of a company in descending order of the number of shares held. Data is sourced from 13F form, Schedule 13D and 13G for US market, UK Share Register for UK market, SEDI for Canadian market and equivalent filings for other international markets.
Pattern Recognition Run pattern recognition algorithm on a symbol. Support double top/bottom, triple top/bottom, head and shoulders, triangle, wedge, channel, flag, and candlestick patterns.
Major Press Releases Get latest major press releases of a company. This data can be used to highlight the most significant events comprised of mostly press releases sourced from the exchanges, BusinessWire, AccessWire, GlobeNewswire, Newsfile, and PRNewswire.Full-text press releases data is available for Enterprise clients. here to learn more.
Price Metrics Get company price performance statistics such as 52-week high/low, YTD return and much more.
Price Target Get latest price target consensus.
Quote Get real-time quote data for US stocks. Constant polling is not recommended. Use websocket if you need real-time updates.Real-time stock prices for international markets are supported for Enterprise clients via our partner's feed. here to learn more.
Recommendation Trends Get latest analyst recommendation trends for a company.
Revenue Breakdown Get revenue breakdown by product. This dataset is only available for US companies which disclose their revenue breakdown in the annual or quarterly reports.
Search In Filing Get a list of excerpts and highlight positions within a document using your query.This endpoint is powered by here
Sector Metrics Get ratios for different sectors and regions/indices.
Similarity Index Calculate the textual difference between a company's 10-K / 10-Q reports and the same type of report in the previous year using Cosine Similarity. For example, this endpoint compares 2019's 10-K with 2018's 10-K. Companies breaking from its routines in disclosure of financial condition and risk analysis section can signal a significant change in the company's stock price in the upcoming 4 quarters.
Social Sentiment Get social sentiment for stocks on Reddit and Twitter. This endpoint is currently in Beta.
Dividends 2 (Basic)
Last Bid-Ask Get last bid/ask data for US stocks.
Dividends
Senate Lobbying
Splits
Stock Symbol
Tick Data Get historical tick data for global exchanges. You can send the request directly to our tick server at here with the same path and parameters or get redirected there if you call our main server.For US market, you can visit our bulk download page in the Dashboard to speed up the download process. See doc for supported exchanges, segments and delays.
USA Spending Get a list of government's spending activities from USASpending dataset for public companies. This dataset can help you identify companies that win big government contracts which is extremely important for industries such as Defense, Aerospace, and Education.
USPTO Patents List USPTO patents for companies. Limit to 250 records per API call.
H1-B Visa Application Get a list of H1-B and Permanent visa applications for companies from the DOL. The data is updated quarterly.
Supply Chain Relationships This endpoint provides an overall map of public companies' key customers and suppliers. The data offers a deeper look into a company's supply chain and how products are created. The data will help investors manage risk, limit exposure or generate alpha-generating ideas and trading insights.
Support/Resistance Get support and resistance levels for a symbol.
Symbol Change Get a list of symbol changes for US-listed, EU-listed, NSE and ASX securities. Limit to 2000 events at a time.
Symbol Lookup Search for best-matching symbols based on your query. You can input anything from symbol, security's name to ISIN and Cusip.
Earnings Call Transcripts Get earnings call transcripts, audio and participants' list. Data is available for US, UK, European, Australian and Canadian companies.15+ years of data is available with 220,000+ audio which add up to 7TB in size.
Earnings Call Transcripts List List earnings call transcripts' metadata. This endpoint is available for US, UK, European, Australian and Canadian companies.
Stock Upgrade/Downgrade Get latest stock upgrade and downgrade.