rocketkind
Finance

Finnhub

Finnhub is a market-data API: stock quotes and candles, company profiles and fundamentals, analyst estimates, insider trades, company and market news, earnings and IPO calendars, forex and crypto.

Authentication

  • API key

Actions

Generic API request. Call any Finnhub API endpoint on this connection, for the case where no shipped action covers it yet. The connection supplies the base URL, the authentication and the egress route, so only the path and query are yours to fill.

  • Get basic financialsGet a company's key ratios and metrics — P/E, margins, beta, 52-week high and low, returns, dividend yield and more — plus annual and quarterly time series of those ratios.
  • Get company profileLook up a listed company's profile: name, ticker, exchange, country, currency, industry, IPO date, market capitalization, shares outstanding, website and logo.
  • Get crypto candlesGet OHLCV candles for a crypto trading pair between two UNIX timestamps at a chosen resolution.
  • Get earnings calendarList past and upcoming earnings releases in a date window — symbol, date, before-open or after-close timing, EPS and revenue estimates and actuals.
  • Get economic calendarList recent and upcoming macroeconomic releases — event name, country, release time, impact level, and the previous, estimated and actual values.
  • Get forex ratesGet conversion rates from one base currency to every other currency Finnhub carries, for the latest data or a past date.
  • Get IPO calendarList recent and upcoming IPOs in a date window with symbol, company name, exchange, date, status (expected, priced, withdrawn or filed), price range and deal size.
  • Get price targetGet the analyst price-target consensus for a company — high, low, mean and median target, number of analysts and when it was last updated.
  • Get quoteGet the latest price for a US stock: current price c, change d and percent change dp, the day's open, high and low, and the previous close pc.
  • Get recommendation trendsGet the monthly count of analyst ratings for a company — strong buy, buy, hold, sell, strong sell — newest period first.
  • Get stock candlesGet OHLCV candles for a stock between two UNIX timestamps at a chosen resolution, for charting or backtesting.
  • List company newsList news articles about one North American company published between two dates, newest first, each with headline, summary, source, URL and publish time.
  • List crypto exchangesList the crypto exchanges Finnhub carries, as a flat array of plain names — mostly upper-cased (KRAKEN, COINBASE) with some title-cased (Binance).
  • List crypto symbolsList the trading pairs Finnhub carries on one crypto exchange.
  • List insider transactionsList insider trades in a company from Form 3/4/5, SEDI and equivalent filings — insider name, shares changed, shares held after, price, transaction code, and filing and trade dates.
  • List market newsList the latest general market headlines for a category — general, forex, crypto or merger — newest first.
  • List stock symbolsList every security Finnhub supports on one exchange, with its symbol, name, type, currency, MIC and FIGI.
  • Search symbolsFind the Finnhub symbol for a company, fund or other security from free text — a name, a ticker, an ISIN or a CUSIP.

Product names, logos and brands are the property of their respective owners and are used here for identification only. Their use does not imply endorsement by, or affiliation with, those owners.