Skip to content

Finnhub API and MCP

Finnhub provides stock prices, company fundamentals, financial news and alternative market data. An agent can read stock quotes, company information and market news for research. Add your Finnhub key once in Longwave settings; calls run on your vendor account.

Add to Longwave

Add Finnhub to your agent

Paste this into Claude Code or a terminal. Then run /mcp to sign in.

functions
102
access
Your key
tasks
25

Use Finnhub on Longwave

  1. Download Longwave or open app.longwave.run.
  2. Add your Finnhub API key once in Longwave settings. Calls run on your Finnhub account at Finnhub's price.
  3. Ask for the result in any thread, for example: “Read a stock quote for a market brief”. The agent picks the Finnhub function and calls it.

Use Finnhub in Claude Code, Codex, Cursor or ChatGPT

Add the Longwave MCP server once. It carries 2,593 functions across 103 tools, including Finnhub, and asks you to sign in on first use.

Why call Finnhub through Longwave

  • Your Finnhub key is stored once, encrypted, and used by every harness and device you use.
  • One MCP server for 103 tools, so your agent setup does not grow a key and a server per vendor.
  • Spending limits per key and per account, checked before a paid call is made.
  • Each call is recorded with the provider, the cost and the result, and can be read again from another device.

Finnhub functions

Stocks 82

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
List changes to security ISINs Accepts a start date and an end date and returns changes to ISINs for listed securities. finnhub.openapi.get.ca.isin-change
List stock ticker changes Accepts a start date and an end date and returns old and new ticker symbols and their change dates. finnhub.openapi.get.ca.symbol-change
Get an earnings calendar Accepts a ticker symbol, a start date and an end date and returns earnings release dates and EPS and revenue estimates. finnhub.openapi.get.calendar.earnings
Get an IPO calendar Accepts a start date and an end date and returns recent and upcoming initial public offerings. finnhub.openapi.get.calendar.ipo
Get company news Accepts a ticker symbol, a start date and an end date and returns news articles about a company. finnhub.openapi.get.company-news
Get an ETF's country exposure Accepts a ticker symbol and returns ETF holdings exposure by country. finnhub.openapi.get.etf.country
Get an ETF's holdings Accepts a ticker symbol and a date and returns ETF constituents and their portfolio weights. finnhub.openapi.get.etf.holdings
Get an ETF profile Accepts a ticker symbol and returns ETF reference and fund profile information. finnhub.openapi.get.etf.profile
Get an ETF's sector exposure Accepts a ticker symbol and returns ETF holdings exposure by sector. finnhub.openapi.get.etf.sector
Get a stock index's constituents Accepts a ticker symbol and returns the stock symbols included in an index. finnhub.openapi.get.index.constituents
Get historical stock index constituents Accepts a ticker symbol and returns index constituents and their joining and leaving dates. finnhub.openapi.get.index.historical-constituents
Get a stock's institutional owners Accepts a ticker symbol, a start date and an end date and returns institutional investors' holdings in a stock over time. finnhub.openapi.get.institutional.ownership
Get an institutional investor's portfolio Accepts a company CIK code, a start date and an end date and returns institutional portfolio positions from 13F filings. finnhub.openapi.get.institutional.portfolio
Get an institutional investor profile Accepts a company CIK code and returns institutional investor profile information. finnhub.openapi.get.institutional.profile
Get a mutual fund's country exposure Accepts a ticker symbol and returns mutual fund exposure by country. finnhub.openapi.get.mutual-fund.country
Get a mutual fund's environmental disclosures Accepts an ISIN and returns European ESG Template disclosures for a fund. finnhub.openapi.get.mutual-fund.eet
Get a mutual fund's adverse impact disclosures Accepts an ISIN and returns principal adverse impact disclosures for a European fund. finnhub.openapi.get.mutual-fund.eet-pai
Get a mutual fund's holdings Accepts a ticker symbol and returns mutual fund constituents and portfolio weights. finnhub.openapi.get.mutual-fund.holdings
Get a mutual fund profile Accepts a ticker symbol and returns mutual fund reference and profile information. finnhub.openapi.get.mutual-fund.profile
Get a mutual fund's sector exposure Accepts a ticker symbol and returns mutual fund exposure by sector. finnhub.openapi.get.mutual-fund.sector
Get financial market news Accepts a category and returns the latest financial market news articles. finnhub.openapi.get.news
Get company news sentiment Accepts a ticker symbol and returns company news sentiment scores and article statistics. finnhub.openapi.get.news-sentiment
Get company press releases Accepts a ticker symbol, a start date and an end date and returns major company press releases. finnhub.openapi.get.press-releases
Get a stock quote Accepts a ticker symbol and returns the latest stock quote and price change. finnhub.openapi.get.quote
Find stock chart patterns Accepts a ticker symbol and a bar interval and returns recognized chart and candlestick patterns. finnhub.openapi.get.scan.pattern
Get stock support and resistance levels Accepts a ticker symbol and a bar interval and returns support and resistance price levels. finnhub.openapi.get.scan.support-resistance
Get aggregate technical trading signals Accepts a ticker symbol and a bar interval and returns combined signals from multiple technical indicators. finnhub.openapi.get.scan.technical-indicator
Search stock ticker symbols Accepts a search term and an exchange code and returns matching security symbols and names. finnhub.openapi.get.search
Get financial ratios by sector Accepts a region and returns financial ratios grouped by sector. finnhub.openapi.get.sector.metrics
Get historical stock bid and ask quotes Accepts a ticker symbol and a date and returns historical best bid and offer prices and sizes. finnhub.openapi.get.stock.bbo
Get the latest stock bid and ask Accepts a ticker symbol and returns the latest stock bid and ask prices and sizes. finnhub.openapi.get.stock.bidask
Get stock price bars Accepts a ticker symbol, a bar interval, a start date and an end date and returns stock open, high, low, close and volume bars. finnhub.openapi.get.stock.candle
List stock dividends Accepts a ticker symbol, a start date and an end date and returns dividend amounts and distribution dates. finnhub.openapi.get.stock.dividend
List stock dividends (basic) Accepts a ticker symbol and returns dividend amounts and distribution dates. finnhub.openapi.get.stock.dividend2
Get historical earnings surprises Accepts a ticker symbol and returns reported quarterly EPS, estimates and earnings surprises. finnhub.openapi.get.stock.earnings
Get earnings call audio links Accepts a ticker symbol, a start date and an end date and returns scheduled earnings calls and stream or recording links. finnhub.openapi.get.stock.earnings-call-live
Get a company's earnings quality score Accepts a ticker symbol and a reporting frequency and returns company earnings quality scores. finnhub.openapi.get.stock.earnings-quality-score
Get company EBIT estimates Accepts a ticker symbol and a reporting frequency and returns analyst estimates of company EBIT. finnhub.openapi.get.stock.ebit-estimate
Get company EBITDA estimates Accepts a ticker symbol and a reporting frequency and returns analyst estimates of company EBITDA. finnhub.openapi.get.stock.ebitda-estimate
Get company earnings per share estimates Accepts a ticker symbol and a reporting frequency and returns analyst estimates of company earnings per share. finnhub.openapi.get.stock.eps-estimate
Get a company's ESG scores Accepts a ticker symbol and returns the latest company ESG scores and indicators. finnhub.openapi.get.stock.esg
List company executives Accepts a ticker symbol and returns company executives and board members. finnhub.openapi.get.stock.executive
List a company's SEC filings Accepts a ticker symbol, an SEC accession number, a filing form type and a start date and returns SEC filing metadata and document links. finnhub.openapi.get.stock.filings
Get sentiment scores for an SEC filing Accepts an SEC accession number and returns positive and negative word statistics for an SEC filing. finnhub.openapi.get.stock.filings-sentiment
Get company financial statements Accepts a ticker symbol, a statement type and a reporting frequency and returns standardized income statements, balance sheets and cash flow statements. finnhub.openapi.get.stock.financials
Get company financial statements as reported Accepts a ticker symbol, an SEC accession number, a reporting frequency and a start date and returns financial statements as reported in company filings. finnhub.openapi.get.stock.financials-reported
List funds that own a stock Accepts a ticker symbol and returns fund investors and their stock holdings. finnhub.openapi.get.stock.fund-ownership
Get historical company employee counts Accepts a ticker symbol, a start date and an end date and returns company employee counts over time. finnhub.openapi.get.stock.historical-employee-count
Get historical company ESG scores Accepts a ticker symbol and returns company ESG scores and indicators over time. finnhub.openapi.get.stock.historical-esg
Get historical company market capitalization Accepts a ticker symbol, a start date and an end date and returns company market capitalization over time. finnhub.openapi.get.stock.historical-market-cap
Get company insider sentiment Accepts a ticker symbol, a start date and an end date and returns monthly insider trading sentiment scores. finnhub.openapi.get.stock.insider-sentiment
List company insider trades Accepts a ticker symbol, a start date and an end date and returns reported insider stock purchases and sales. finnhub.openapi.get.stock.insider-transactions
List international company filings Accepts a ticker symbol, a country code, a start date and an end date and returns filing metadata and links for international companies. finnhub.openapi.get.stock.international-filings
List companies in an investment theme Accepts an investment theme and returns companies associated with it. finnhub.openapi.get.stock.investment-theme
List company lobbying activity Accepts a ticker symbol, a start date and an end date and returns reported company lobbying activities. finnhub.openapi.get.stock.lobbying
List stock exchange holidays Accepts an exchange code and returns market holiday dates and trading hours. finnhub.openapi.get.stock.market-holiday
Get stock exchange trading status Accepts an exchange code and returns current stock exchange trading status. finnhub.openapi.get.stock.market-status
Get company financial metrics Accepts a ticker symbol and a metric type and returns company financial ratios and key metrics. finnhub.openapi.get.stock.metric
Get articles from a company's newsroom Accepts a ticker symbol, a start date and an end date and returns articles from company newsroom and investor relations pages. finnhub.openapi.get.stock.newsroom
List a company's shareholders Accepts a ticker symbol and returns company shareholders and their share holdings. finnhub.openapi.get.stock.ownership
Find a company's industry peers Accepts a ticker symbol and returns peer companies in the same country and industry. finnhub.openapi.get.stock.peers
List company presentation documents Accepts a ticker symbol and returns company presentation metadata and PDF links. finnhub.openapi.get.stock.presentation
Get stock price performance metrics Accepts a ticker symbol and a date and returns stock price performance statistics. finnhub.openapi.get.stock.price-metric
Get analyst stock price targets Accepts a ticker symbol and returns consensus stock price targets from analysts. finnhub.openapi.get.stock.price-target
Get a listed company profile Accepts a ticker symbol and returns company reference and business profile information. finnhub.openapi.get.stock.profile
Get a listed company profile (basic) Accepts a ticker symbol and returns company reference and business profile information. finnhub.openapi.get.stock.profile2
Get analyst stock recommendation trends Accepts a ticker symbol and returns analyst buy, hold and sell recommendation counts. finnhub.openapi.get.stock.recommendation
Get company revenue by segment Accepts a ticker symbol and returns reported revenue by product and geographic segment. finnhub.openapi.get.stock.revenue-breakdown
Get standardized revenue segments and company KPIs Accepts a ticker symbol and returns standardized revenue segments and company operating metrics. finnhub.openapi.get.stock.revenue-breakdown2
Get company revenue estimates Accepts a ticker symbol and a reporting frequency and returns analyst estimates of company revenue. finnhub.openapi.get.stock.revenue-estimate
Compare a company's annual or quarterly filings Accepts a ticker symbol and a reporting frequency and returns textual similarity scores between consecutive company reports. finnhub.openapi.get.stock.similarity-index
Get social sentiment about a stock Accepts a ticker symbol, a start date and an end date and returns Reddit and X sentiment statistics about a stock. finnhub.openapi.get.stock.social-sentiment
List stock splits Accepts a ticker symbol, a start date and an end date and returns stock split dates and ratios. finnhub.openapi.get.stock.split
Get a company's customers and suppliers Accepts a ticker symbol and returns relationships between a company, its customers and suppliers. finnhub.openapi.get.stock.supply-chain
List stock ticker symbols Accepts an exchange code and an exchange MIC code and returns supported stock symbols and exchange metadata. finnhub.openapi.get.stock.symbol
List individual stock trades Accepts a ticker symbol and a date and returns historical stock trade prices, sizes and timestamps. finnhub.openapi.get.stock.tick
Get an earnings call transcript Returns the full transcript of an earnings call, with participants and audio links, for a transcript ID. finnhub.openapi.get.stock.transcripts
List a company's earnings call transcripts Accepts a ticker symbol and returns earnings call transcript identifiers and metadata. finnhub.openapi.get.stock.transcripts.list
Get stock analyst rating changes Accepts a ticker symbol, a start date and an end date and returns analyst upgrades, downgrades and rating changes. finnhub.openapi.get.stock.upgrade-downgrade
List US government contracts for a company Accepts a ticker symbol, a start date and an end date and returns US government spending records associated with a company. finnhub.openapi.get.stock.usa-spending
List a company's US patents Accepts a ticker symbol, a start date and an end date and returns USPTO patent records associated with a company. finnhub.openapi.get.stock.uspto-patent
List a company's US work visa applications Accepts a ticker symbol, a start date and an end date and returns company H1-B and permanent work visa applications. finnhub.openapi.get.stock.visa-application

Economic data 4

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
Get airline ticket price indexes Accepts an airline code, a start date and an end date and returns daily airline ticket prices and price indexes. finnhub.openapi.get.airline.price-index
Get an economic release calendar Accepts a start date and an end date and returns scheduled economic releases and reported figures. finnhub.openapi.get.calendar.economic
Get an economic data series Accepts a data series code and returns observations from an economic data series. finnhub.openapi.get.economic
List economic data series codes Returns supported economic series names and codes without requiring input parameters. finnhub.openapi.get.economic.code

Bonds 4

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
Get historical bond prices Accepts an ISIN, a start date and an end date and returns historical bond prices. finnhub.openapi.get.bond.price
Get a bond profile Accepts an ISIN, a CUSIP and a FIGI and returns bond reference information. finnhub.openapi.get.bond.profile
List individual bond trades Accepts an ISIN, a date and an exchange code and returns trade prices, sizes and timestamps for a bond. finnhub.openapi.get.bond.tick
Get a Treasury yield curve Accepts a data series code and returns Treasury bond yields by maturity. finnhub.openapi.get.bond.yield-curve

Cryptocurrency 4

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
Get cryptocurrency price bars Accepts a ticker symbol, a bar interval, a start date and an end date and returns cryptocurrency open, high, low, close and volume bars. finnhub.openapi.get.crypto.candle
List cryptocurrency exchanges Returns supported cryptocurrency exchange names without requiring input parameters. finnhub.openapi.get.crypto.exchange
Get a cryptocurrency profile Accepts a ticker symbol and returns cryptocurrency profile information. finnhub.openapi.get.crypto.profile
List cryptocurrency trading pairs Accepts an exchange code and returns supported cryptocurrency trading symbols. finnhub.openapi.get.crypto.symbol

Foreign exchange 4

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
Get foreign exchange price bars Accepts a ticker symbol, a bar interval, a start date and an end date and returns currency pair open, high, low and close bars. finnhub.openapi.get.forex.candle
List foreign exchange data sources Returns supported foreign exchange data sources without requiring input parameters. finnhub.openapi.get.forex.exchange
Get currency exchange rates Accepts a base currency and an optional date and returns exchange rates for currency conversion. finnhub.openapi.get.forex.rates
List foreign exchange trading pairs Accepts an exchange code and returns supported foreign exchange trading symbols. finnhub.openapi.get.forex.symbol

Health 2

Every function here: Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published. Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Function
Get COVID-19 case counts for US states Returns COVID-19 case counts by US state without requiring input parameters. finnhub.openapi.get.covid19.us
Get the FDA advisory committee calendar Returns scheduled FDA advisory committee meetings without requiring input parameters. finnhub.openapi.get.fda-advisory-committee-calendar

Public data 1

Function Price
List countries and their metadata Returns country names, codes and metadata without requiring input parameters. finnhub.openapi.get.country
Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

US Congress 1

Function Price
List stock trades by members of the US Congress Accepts a ticker symbol, a start date and an end date and returns stock trades disclosed by members of Congress. finnhub.openapi.get.stock.congressional-trading
Included in the applicable market-data subscription or free quota; entitlement and usage limits vary by endpoint. No standalone PAYG unit rate published.

Prices are Finnhub's published rates. Source: Finnhub pricing.

Use cases

Questions people ask

How do I get a Finnhub API key?

Sign in to Finnhub and create a key at finnhub.io/dashboard. Add it once in Longwave settings and your agents' Finnhub calls run on your own account. Finnhub API keys

Do I need a Finnhub account?

Yes. Create a key at https://finnhub.io/dashboard and add it in Longwave settings. Longwave stores it encrypted and uses it only for your calls.

How do I use Finnhub in Claude Code?

Add the Longwave MCP server once with claude mcp add --transport http longwave https://api.longwave.run/v1/mcp/tasks, sign in, and ask for what you need. Claude finds the right Finnhub function and calls it.

Use Finnhub in Longwave

Ask any Longwave thread for the result, or add Longwave to Claude Code, Codex, Cursor or ChatGPT.

Add to Longwave