- functions
- 102
- access
- Your key
- tasks
- 25
Use Finnhub on Longwave
- Download Longwave or open app.longwave.run.
- Add your Finnhub API key once in Longwave settings. Calls run on your Finnhub account at Finnhub's price.
- 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
- Read a stock quote for a market brief Retrieve quote data for the requested symbol.
- Research a company before writing a report Read the available company profile.
- Find company news for a research brief Retrieve news related to the selected company.