Integration

Finnhub integration

Finnhub is a financial market data API. With it an agent can search stock symbols, read real-time US quotes and candles, company profiles, basic financials, financial statements and as-reported SEC financials, earnings, estimates and analyst recommendations, insider transactions and sentiment, ownership, filings and transcripts, ETF, mutual fund, bond, forex and crypto data, market and company news, IPO, earnings and economic calendars, technical indicators and alternative data (ESG, patents, lobbying, government spending, visa applications), and ask Finnhub's AI copilot. Many tools need a paid plan; each tool says which. The filing document download is not exposed (it returns a file, not JSON). Authentication is an API key from the Finnhub dashboard, sent in the X-Finnhub-Token header. Over the plan's own limit Finnhub answers 429, and every plan is also capped at 30 calls per second.

Connect FinnhubHow integrations work
Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Finnhub.Built from the 115 Finnhub tools below, on the connection you add once.

What you can do with Finnhub

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Profile, 6 operations

  • get_bond_profileGet bond profileGETGet general information of a bond. You can query by FIGI, ISIN or CUSIP. Requires a paid Finnhub plan.
  • get_company_profileGet company profileGETGet general information of a company. You can query by symbol, ISIN or CUSIP. Requires a paid Finnhub plan.
  • get_crypto_profileGet crypto profileGETGet crypto's profile. Requires a paid Finnhub plan.
  • get_etf_profileGet etf profileGETGet ETF profile information. This endpoint has global coverage. Requires a paid Finnhub plan.
  • get_mutual_fund_profileGet mutual fund profileGETGet mutual funds profile information. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN. Requires a paid Finnhub plan.
  • institutional_profileInstitutional profileGETGet a list of well-known institutional investors. Currently support 60+ profiles. Requires a paid Finnhub plan.

Symbol, 4 operations

  • crypto_symbolsCrypto symbolsGETList supported crypto symbols by exchange. Available on the free plan.
  • forex_symbolsForex symbolsGETList supported forex symbols. Available on the free plan.
  • search_symbolsSearch symbolsGETSearch for best-matching symbols based on your query. You can input anything from symbol, security's name to ISIN and Cusip. Available on the free plan.
  • stock_symbolsStock symbolsGETList the stocks Finnhub supports on one exchange (pass the exchange code, US for US exchanges). Finnhub writes symbols as Ticker.ExchangeCode for non-US listings. Available on the free plan.

Candle, 3 operations

  • crypto_candlesCrypto candlesGETGet candlestick data for crypto symbols. Requires a paid Finnhub plan.
  • forex_candlesForex candlesGETGet candlestick data for forex symbols. Requires a paid Finnhub plan.
  • stock_candlesStock candlesGETGet candlestick data (OHLCV) for stocks. Daily data will be adjusted for Splits. Intraday data will remain unadjusted. Only 1 month of intraday will be returned at a time. Requires a paid Finnhub plan.

Country, 3 operations

  • etfs_country_exposureEtfs country exposureGETGet ETF country exposure data. Requires a paid Finnhub plan.
  • list_countriesList countriesGETList all countries and metadata. Available on the free plan.
  • mutual_fund_country_exposureMutual fund country exposureGETGet Mutual Funds country exposure data. Requires a paid Finnhub plan.

Earning, 2 operations

  • company_earningsCompany earningsGETGet company historical quarterly earnings surprise going back to 2000. Free plan: Last 4 quarters.
  • earnings_calendarEarnings calendarGETGet 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. Free plan: 1 month of historical earnings and new updates.

Economic, 2 operations

  • economic_calendarEconomic calendarGETGet recent and upcoming economic releases between two dates. Historical events and surprises are available for Enterprise clients. Requires a paid Finnhub plan.
  • economic_dataEconomic dataGETGet economic data. Requires the Fundamental data or All in One subscription.

Exchange, 2 operations

  • crypto_exchangesCrypto exchangesGETList supported crypto exchanges. Available on the free plan.
  • forex_exchangesForex exchangesGETList supported forex exchanges. Available on the free plan.

Filing, 2 operations

  • list_filingsList filingsGETList a company's SEC filings, by symbol, CIK, accessNumber or form; leave all empty for the latest filings. Limit to 250 documents at a time. Available on the free plan.
  • search_global_filingsSearch global filingsPOSTSearch 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. Requires a paid Finnhub plan.

Holding, 2 operations

  • etfs_holdingsEtfs holdingsGETGet full ETF holdings/constituents. This endpoint has global coverage. Requires a paid Finnhub plan.
  • mutual_fund_holdingsMutual fund holdingsGETGet full Mutual Funds holdings/constituents. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN. Requires a paid Finnhub plan.

Metric, 2 operations

  • get_company_basic_financialsGet company basic financialsGETGet company basic financials such as margin, P/E ratio, 52-week high/low etc. Available on the free plan.
  • sector_metricSector metricGETGet ratios for different sectors and regions/indices. Requires a paid Finnhub plan.

Ownership, 2 operations

  • institutional_ownershipInstitutional ownershipGETGet a list institutional investors' positions for a particular stock overtime. Data from 13-F filings. Limit to 1 year of data at a time. Requires a paid Finnhub plan.
  • list_stock_ownershipList stock ownershipGETGet a full list of shareholders of a company in descending order of the number of shares held. Requires a paid Finnhub plan.

Sector, 2 operations

  • etfs_sector_exposureEtfs sector exposureGETGet ETF sector exposure data. Requires a paid Finnhub plan.
  • mutual_fund_sector_exposureMutual fund sector exposureGETGet Mutual Funds sector exposure data. Requires a paid Finnhub plan.

Tick, 2 operations

  • bond_tickBond tickGETGet trade-level data for a bond by ISIN on one date, paged with limit and skip. Covers FINRA Trace US corporate and 144A bonds. Requires a paid Finnhub plan.
  • stock_tickStock tickGETGet historical tick (trade-level) data for a stock on one date, paged with limit (max 25000) and skip. Covers US (end-of-day), TSX, LSE, Euronext and Deutsche Borse venues. Requires a paid Finnhub plan.

Transcript, 2 operations

  • get_transcriptGet transcriptGETGet 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. Requires a paid Finnhub plan.
  • list_transcriptsList transcriptsGETList earnings call transcripts' metadata. This endpoint is available for Global companies. Requires a paid Finnhub plan.

Ai copilot, 1 operation

  • ask_ai_copilotAsk ai copilotPOSTAsk Finnhub's AI copilot a finance question (messages with role system or user). Returns a text answer, related queries, tickers mentioned and sources. Requires a paid Finnhub plan.

Allocation, 1 operation

  • etfs_allocationEtfs allocationGETGet ETF equity allocation based on the characteristics of the holdings. Requires a paid Finnhub plan.

Bank branch, 1 operation

  • bank_branchBank branchGETRetrieve list of US bank branches information for a given symbol. Requires the Fundamental or All in One subscription.

Bbo, 1 operation

  • stock_nbboStock nbboGETGet historical best bid and offer for US stocks, LSE, TSX, Euronext and Deutsche Borse. For US market, this endpoint only serves historical NBBO from the beginning of 2026. Requires a paid Finnhub plan.

Bidask, 1 operation

  • get_last_bid_askGet last bid askGETGet last bid/ask data for US stocks. Requires a paid Finnhub plan.

Capex estimate, 1 operation

  • company_capex_estimatesCompany capex estimatesGETGet company's capital expenditure estimates. Requires a paid Finnhub plan.

Code, 1 operation

  • economic_codeEconomic codeGETList codes of supported economic data. Requires the Fundamental data or All in One subscription.

Company news, 1 operation

  • list_company_newsList company newsGETList latest company news by symbol. This endpoint is only available for North American companies. Free plan: 1 year of historical news and new updates.

Congressional trading, 1 operation

  • congressional_tradingCongressional tradingGETGet stock trades data disclosed by members of congress. Requires a paid Finnhub plan.

Constituent, 1 operation

  • indices_constituentsIndices constituentsGETGet a list of index's constituents. Requires a paid Finnhub plan.

Covid19 case, 1 operation

  • list_covid19_us_casesList covid19 us casesGETGet real-time updates on the number of COVID-19 (Corona virus) cases in the US with a state-by-state breakdown. Data is sourced from CDC and reputable sources. Available on the free plan.

Dividend, 1 operation

  • stock_dividendsStock dividendsGETGet dividends data for common stocks going back 30 years. Requires a paid Finnhub plan.

Dividend2, 1 operation

  • list_basic_dividendsList basic dividendsGETGet global dividends data. Requires a paid Finnhub plan.

Dps estimate, 1 operation

  • company_dps_estimatesCompany dps estimatesGETGet company's Dividend per Share estimates. Requires a paid Finnhub plan.

Earnings call live, 1 operation

  • earnings_call_liveEarnings call liveGETList live and recent earnings call audio events between two dates: a live m3u8 stream URL, and an mp3 recording URL once the call finishes. Requires a paid Finnhub plan.

Earnings quality score, 1 operation

  • company_earnings_quality_scoreCompany earnings quality scoreGETThis endpoint provides Earnings Quality Score for global companies. Earnings quality refers to the extent to which current earnings predict future earnings. Requires a paid Finnhub plan.

Ebit estimate, 1 operation

  • company_ebit_estimatesCompany ebit estimatesGETGet company's ebit estimates. Requires a paid Finnhub plan.

Ebitda estimate, 1 operation

  • company_ebitda_estimatesCompany ebitda estimatesGETGet company's ebitda estimates. Requires a paid Finnhub plan.

Eet, 1 operation

  • mutual_fund_eetMutual fund eetGETGet EET data for EU funds. For PAIs data, please see the EET PAI endpoint. Requires a paid Finnhub plan.

Eet pai, 1 operation

  • mutual_fund_eet_paiMutual fund eet paiGETGet EET PAI data for EU funds. Requires a paid Finnhub plan.

Eps estimate, 1 operation

  • company_eps_estimatesCompany eps estimatesGETGet company's EPS estimates. Requires a paid Finnhub plan.

Esg, 1 operation

  • company_esg_scoreCompany esg scoreGETThis endpoint provides the latest ESG scores and important indicators for 7000+ global companies. The data is collected through company's public ESG disclosure and public sources. Requires a paid Finnhub plan.

Executive, 1 operation

  • company_executiveCompany executiveGETGet a list of company's executives and members of the Board. Requires a paid Finnhub plan.

Fcf estimate, 1 operation

  • company_fcf_estimatesCompany fcf estimatesGETGet company's free cash flow estimates. Requires a paid Finnhub plan.

Fda advisory committee calendar, 1 operation

  • fda_committee_meeting_calendarFda committee meeting calendarGETList FDA advisory committee meetings (from and to dates, event description, url). Available on the free plan.

Filing excerpt, 1 operation

  • search_in_filingSearch in filingPOSTGet a list of excerpts and highlight positions within a document using your query. Requires a paid Finnhub plan.

Filings sentiment, 1 operation

  • filings_sentimentFilings sentimentGETGet 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. Requires a paid Finnhub plan.

Filter, 1 operation

  • list_global_filings_filtersList global filings filtersGETGet available values for each filter in search body. Requires a paid Finnhub plan.

Financial, 1 operation

  • get_financial_statementsGet financial statementsGETGet standardized balance sheet, income statement and cash flow for global companies going back 30+ years. Requires a paid Finnhub plan.

Financials reported, 1 operation

  • list_financials_reportedList financials reportedGETGet financials as reported in SEC filings (balance sheet, income statement, cash flow), by symbol, CIK or accessNumber. Available on the free plan.

Fund ownership, 1 operation

  • fund_ownershipFund ownershipGETGet a full list fund and institutional investors of a company in descending order of the number of shares held. Requires a paid Finnhub plan.

Gross income estimate, 1 operation

  • company_gross_income_estimatesCompany gross income estimatesGETGet company's gross income estimates. Requires a paid Finnhub plan.

Historical employee count, 1 operation

  • historical_employee_countHistorical employee countGETGet historical employee count for global companies. Requires the Fundamental 2 or All in One subscription.

Historical esg, 1 operation

  • company_historical_esg_scoreCompany historical esg scoreGETThis endpoint provides historical ESG scores and important indicators for 7000+ global companies. The data is collected through company's public ESG disclosure and public sources. Requires a paid Finnhub plan.

Historical market cap, 1 operation

  • historical_market_capHistorical market capGETGet historical market cap data for global companies. Requires the Fundamental 2 or All in One subscription.

Indicator, 1 operation

  • get_technical_indicatorGet technical indicatorGETReturn technical indicator with price data. Requires a paid Finnhub plan.

Insider sentiment, 1 operation

  • insider_sentimentInsider sentimentGETGet monthly insider sentiment (MSPR) for a US company. The MSPR ranges from -100 for the most negative to 100 for the most positive and can signal price changes in the coming 30-90 days. Available on the free plan.

Insider transaction, 1 operation

  • insider_transactionsInsider transactionsGETCompany insider transactions data sourced from Form 3,4,5 , SEDI and relevant companies' filings. This endpoint covers US, UK, Canada, Australia, India, and all major EU markets. Limit to 100 transactions per API call. Available on the free plan.

International filing, 1 operation

  • international_filingsInternational filingsGETList filings for international companies. Limit to 500 documents at a time. These are the documents we use to source our fundamental data. Access is granted by Finnhub case by case.

Investment theme, 1 operation

  • investment_themesInvestment themesGETGet the portfolio of companies Finnhub assigns to an investment theme (for example financialExchangesData). The theme coverage and portfolios are updated bi-weekly. Requires a paid Finnhub plan.

Ipo, 1 operation

  • ipo_calendarIpo calendarGETGet recent and upcoming IPO. Available on the free plan.

Isin change, 1 operation

  • isin_changeIsin changeGETGet a list of ISIN changes for EU-listed securities. Limit to 2000 events at a time. Requires a paid Finnhub plan.

Lobbying, 1 operation

  • stock_lobbyingStock lobbyingGETGet a list of reported lobbying activities in the Senate and the House. Available on the free plan.

Market holiday, 1 operation

  • market_holidayMarket holidayGETGet a list of holidays for global exchanges. Available on the free plan.

Market status, 1 operation

  • get_market_statusGet market statusGETGet current market status for global exchanges (whether exchanges are open or close). Available on the free plan.

Net income estimate, 1 operation

  • company_net_income_estimatesCompany net income estimatesGETGet company's net income estimates. Requires a paid Finnhub plan.

News, 1 operation

  • list_market_newsList market newsGETGet latest market news. Available on the free plan.

News sentiment, 1 operation

  • get_news_sentimentGet news sentimentGETGet company's news sentiment and statistics. This endpoint is only available for US companies. Requires a paid Finnhub plan.

Newsroom, 1 operation

  • newsroomNewsroomGETGet latest articles posted directly on the companies' newsroom and investor relations page. Newsroom API along with the Press Releases API provide a comprehensive text-based dataset directly from the company. Requires a paid Finnhub plan.

Ocf estimate, 1 operation

  • company_ocf_estimatesCompany ocf estimatesGETGet company's operating cash flow estimates. Requires a paid Finnhub plan.

Pattern, 1 operation

  • pattern_recognitionPattern recognitionGETRun pattern recognition algorithm on a symbol. Support double top/bottom, triple top/bottom, head and shoulders, triangle, wedge, channel, flag, and candlestick patterns. Requires a paid Finnhub plan.

Peer, 1 operation

  • company_peersCompany peersGETGet company peers. Return a list of peers operating in the same country and sector/industry. Available on the free plan.

Portfolio, 1 operation

  • institutional_portfolioInstitutional portfolioGETGet the holdings/portfolio data of institutional investors from 13-F filings. Limit to 1 year of data at a time. Requires a paid Finnhub plan.

Presentation, 1 operation

  • stock_presentationStock presentationGETGet presentations/slides data in PDF format that are usually used during earnings calls. Requires a paid Finnhub plan.

Press release, 1 operation

  • press_releasesPress releasesGETGet latest major press releases of a company. Requires a paid Finnhub plan.

Pretax income estimate, 1 operation

  • company_pretax_income_estimatesCompany pretax income estimatesGETGet company's pretax income estimates. Requires a paid Finnhub plan.

Price, 1 operation

  • bond_priceBond priceGETGet daily price data (close, volume) for a bond by ISIN between two UNIX timestamps. Covers US Government Bonds and International Bonds (end-of-day) and FINRA Trace bonds (delayed 4h). Requires a paid Finnhub plan.

Price index, 1 operation

  • airline_price_indexAirline price indexGETThe Flight Ticket Price Index API provides comprehensive data on airline ticket prices, including the average daily ticket price and its percentage change (price index). Requires the Fundamental data or All in One subscription.

Price metric, 1 operation

  • get_price_metricsGet price metricsGETGet company price performance statistics such as 52-week high/low, YTD return and much more. Requires a paid Finnhub plan.

Price target, 1 operation

  • price_targetPrice targetGETGet latest price target consensus. Requires a paid Finnhub plan.

Profile2, 1 operation

  • get_company_profile_basicGet company profile basicGETGet general information of a company (name, exchange, industry, market cap, logo, website). Query by symbol, ISIN or CUSIP. Free version of get_company_profile. Available on the free plan.

Quote, 1 operation

  • get_quoteGet quoteGETGet the real-time quote of a US stock: current price, change, percent change, day high and low, open and previous close. Constant polling is not recommended. Available on the free plan.

Rate, 1 operation

  • get_forex_ratesGet forex ratesGETGet rates for all forex pairs. Ideal for currency conversion. Requires a paid Finnhub plan.

Recommendation, 1 operation

  • recommendation_trendsRecommendation trendsGETGet latest analyst recommendation trends for a company. Available on the free plan.

Revenue breakdown, 1 operation

  • revenue_breakdownRevenue breakdownGETGet revenue breakdown as reported, by product and geography. Personal plans can access US companies that disclose their revenue breakdown in the annual or quarterly reports. Requires a paid Finnhub plan.

Revenue breakdown2, 1 operation

  • get_revenue_breakdown_kpiGet revenue breakdown kpiGETGet standardized revenue breakdown and KPIs data for 30,000+ global companies. Requires a paid Finnhub plan.

Revenue estimate, 1 operation

  • company_revenue_estimatesCompany revenue estimatesGETGet company's revenue estimates. Requires a paid Finnhub plan.

Similarity index, 1 operation

  • similarity_indexSimilarity indexGETCalculate 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. Requires a paid Finnhub plan.

Social sentiment, 1 operation

  • social_sentimentSocial sentimentGETGet social sentiment for stocks on Reddit and Twitter. Requires a paid Finnhub plan.

Split, 1 operation

  • stock_splitsStock splitsGETGet splits data for stocks. Requires a paid Finnhub plan.

Supply chain, 1 operation

  • supply_chain_relationshipsSupply chain relationshipsGETThis 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. Requires a paid Finnhub plan.

Support resistance, 1 operation

  • support_resistanceSupport resistanceGETGet support and resistance levels for a symbol. Requires a paid Finnhub plan.

Symbol change, 1 operation

  • symbol_changeSymbol changeGETGet a list of symbol changes for US-listed, EU-listed, NSE and ASX securities. Limit to 2000 events at a time. Requires a paid Finnhub plan.

Technical indicator, 1 operation

  • get_aggregate_indicatorGet aggregate indicatorGETGet aggregate signal of multiple technical indicators such as MACD, RSI, Moving Average v.v. Requires a paid Finnhub plan.

Upgrade downgrade, 1 operation

  • upgrade_downgradeUpgrade downgradeGETGet latest stock upgrade and downgrade. Requires a paid Finnhub plan.

Usa spending, 1 operation

  • stock_usa_spendingStock usa spendingGETGet a list of government's spending activities from USASpending dataset for public companies. Available on the free plan.

Uspto patent, 1 operation

  • stock_uspto_patentStock uspto patentGETList USPTO patents for companies. Limit to 250 records per API call. Available on the free plan.

Visa application, 1 operation

  • stock_visa_applicationStock visa applicationGETGet a list of H1-B and Permanent visa applications for companies from the DOL. The data is updated quarterly. Available on the free plan.

Yield curve, 1 operation

  • bond_yield_curveBond yield curveGETGet yield curve data for Treasury bonds. Requires a paid Finnhub plan.

Use Finnhub from Claude Code, Cursor or Codex

Connect Finnhub in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Finnhub operations become tools the client can call, next to every other integration you connected.

Claude Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Finnhub

  1. Create your workspace

    Sign up free. Nothing to install.

  2. Connect Finnhub once

    Add your Finnhub connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.

  3. Describe the job in chat

    The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Finnhub integration FAQ

What can you do with the Finnhub integration?

LiveContext exposes 115 operations on Finnhub, covering profile, symbol, candle and country.

Popular integrations

Instagram (Instagram Login)Instagram API with Instagram Login (graph.instagram.com). Manage a Business/Creator Instagram account…15 toolsOAuthGmailGoogle email service API for sending, receiving, and managing emails. Access messages, threads, labels,…40 toolsOAuthTelegramMessaging platform API for building bots and integrations. Send messages, manage chats and channels, handle…132 toolsCustom authYouTube Data APIGoogle's video platform API for accessing video, channel, playlist, and comment data52 toolsOAuthTwitter / XSocial media platform API for posting, reading, and managing Twitter/X content. Post tweets, read timelines,…29 toolsOAuthLinkedInProfessional networking platform API for managing profiles, connections, and content. Share posts, manage…49 toolsOAuthTikTokSocial media platform API for content creators and businesses. Access user info, manage videos, get…12 toolsOAuthxAIAI API from xAI (Elon Musk's AI company) powering Grok models. Access state-of-the-art language models with…11 toolsToken

Browse the whole catalog