The Finnhub connector lets your AI agent act in each user's Finnhub account. Each user connects their own Finnhub API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 30 · 0 · 030 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Finnhub connection
In AgentKit > Connections, create a Finnhub connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'finnhub'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Finnhub:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'finnhub_get_company_profile',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "finnhub"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Finnhub:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="finnhub_get_company_profile",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Finnhub credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolfinnhub_get_basic_financialsGet a company's key financial metrics and ratio history.Read-onlyGet Basic Financials
Get a company's key financial metrics and ratio history. Returns metric, a map of current values such as peTTM, pbAnnual, epsTTM, dividendYieldIndicatedAnnual, beta, 52WeekHigh, 52WeekLow, 10DayAverageTradingVolume, grossMarginTTM and netProfitMarginTTM, plus series, annual and quarterly histories of ratios such as currentRatio, netMargin and salesPerShare. Use finnhub_get_basic_financials for valuation, margins and 52-week range. Use finnhub_get_financials_as_reported for full statements from SEC filings and finnhub_get_quote for the current price.
Inputs
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
metricstring- Metric group to return. Finnhub accepts all. Example: all.one of
alldefaultall
finnhub_get_company_profileGet a company's profile by ticker symbol, ISIN or CUSIP.Read-onlyGet Company Profile
Get a company's profile by ticker symbol, ISIN or CUSIP. Returns name, ticker, exchange, country, currency, finnhubIndustry, ipo date, marketCapitalization and shareOutstanding (both in millions), weburl, phone and logo URL. An unknown identifier returns an empty object. Use finnhub_get_company_profile for who a company is and its size. Use finnhub_get_basic_financials for ratios and margins, and finnhub_get_peers for comparable companies. Provide exactly one of symbol, isin or cusip.
Inputs
cusipstring- CUSIP of the security, used when symbol and isin are not given. Example: 037833100.
isinstring- ISIN of the security, used when symbol is not given. Example: US0378331005.
symbolstring- Ticker symbol of the company. Provide one of symbol, isin or cusip. Example: AAPL.
finnhub_get_crypto_candlesGet open, high, low, close and volume candles for a crypto pair over a time range.Read-onlyGet Crypto Candles
Get open, high, low, close and volume candles for a crypto pair over a time range. Returns parallel arrays o, h, l, c, v and t (UNIX times) plus s, which is ok or no_data. Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_get_crypto_candles for crypto price history. Get the pair's symbol from finnhub_list_crypto_symbols.
Inputs
fromintegerrequired- Start of the range as a UNIX timestamp in seconds. Example: 1756684800 (2025-09-01 00:00 UTC).
resolutionstringrequired- Candle size: 1, 5, 15, 30 or 60 for minutes, D for daily, W for weekly, M for monthly. Some sizes are not available on every exchange. Example: D.one of
15153060DWM symbolstringrequired- Crypto pair symbol exactly as returned by finnhub_list_crypto_symbols, including the exchange prefix. Example: BINANCE:BTCUSDT.
tointegerrequired- End of the range as a UNIX timestamp in seconds. Example: 1759276800 (2025-10-01 00:00 UTC). Intraday resolutions return at most one month per call.
finnhub_get_earnings_calendarList past and upcoming earnings releases, optionally for one symbol or date range.Read-onlyGet Earnings Calendar
List past and upcoming earnings releases, optionally for one symbol or date range. Returns earningsCalendar, a list of releases with symbol, date, hour (bmo before open, amc after close, dmh during market hours), year, quarter, epsEstimate, epsActual, revenueEstimate and revenueActual. EPS and revenue are non-GAAP. The free plan covers one month of history plus upcoming dates. Use finnhub_get_earnings_calendar to find when companies report. Use finnhub_get_earnings_surprises for one company's beat-or-miss history.
Inputs
fromstring- Start date of the release range, YYYY-MM-DD. Example: 2026-09-01.
internationalboolean- Set to true to include non-US markets. Omit for US only. Example: true.
symbolstring- Only return releases for this ticker. Omit for all companies. Example: AAPL.
tostring- End date of the release range, YYYY-MM-DD. Example: 2026-09-30.
finnhub_get_earnings_surprisesGet a company's quarterly earnings per share against analyst estimates.Read-onlyGet Earnings Surprises
Get a company's quarterly earnings per share against analyst estimates. Returns one entry per quarter with period, year, quarter, actual, estimate, surprise and surprisePercent, newest first. The free plan returns the last four quarters. Use finnhub_get_earnings_surprises for a company's beat-or-miss history. Use finnhub_get_earnings_calendar for upcoming report dates.
Inputs
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
limitinteger- Maximum number of quarters to return. Omit for the full history your plan allows. Example: 4.
finnhub_get_economic_calendarList recent and upcoming economic data releases such as GDP, CPI and jobs reports.Read-onlyGet Economic Calendar
List recent and upcoming economic data releases such as GDP, CPI and jobs reports. Returns economicCalendar, a list of releases with event, country, time, impact (low, medium or high), actual, estimate, prev and unit. Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_get_economic_calendar for macro events. Use finnhub_get_earnings_calendar for company earnings dates.
Inputs
fromstring- Start date of the release range, YYYY-MM-DD. Example: 2026-09-01.
tostring- End date of the release range, YYYY-MM-DD. Example: 2026-09-30.
finnhub_get_financials_as_reportedGet a company's financial statements exactly as reported in its SEC 10-K or 10-Q filings.Read-onlyGet Financials As Reported
Get a company's financial statements exactly as reported in its SEC 10-K or 10-Q filings. Returns symbol, cik and data, one entry per filing with year, quarter, form, startDate, endDate, filedDate, accessNumber and report, which holds the balance sheet (bs), income statement (ic) and cash flow (cf) line items as filed. Responses for a full history are large; narrow with from and to. Use finnhub_get_financials_as_reported for full statements. Use finnhub_get_basic_financials for ready-made ratios. Provide symbol, cik or access_number.
Inputs
access_numberstring- Accession number of one filing to return financials from. Example: 0000320193-24-000123.
cikstring- SEC Central Index Key of the company, used instead of symbol. Example: 320193.
freqstring- Statement frequency: annual (10-K) or quarterly (10-Q). Omit for annual. Example: quarterly.one of
annualquarterly fromstring- Start date of the period end range, YYYY-MM-DD. Example: 2026-09-01.
symbolstring- Ticker symbol of the company. Provide one of symbol, cik or access_number. Example: AAPL.
tostring- End date of the period end range, YYYY-MM-DD. Example: 2026-09-30.
finnhub_get_forex_candlesGet open, high, low, close and volume candles for a currency pair over a time range.Read-onlyGet Forex Candles
Get open, high, low, close and volume candles for a currency pair over a time range. Returns parallel arrays o, h, l, c, v and t (UNIX times) plus s, which is ok or no_data. Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_get_forex_candles for one pair's price history. Use finnhub_get_forex_rates for current conversion rates. Get the pair's symbol from finnhub_list_forex_symbols.
Inputs
fromintegerrequired- Start of the range as a UNIX timestamp in seconds. Example: 1756684800 (2025-09-01 00:00 UTC).
resolutionstringrequired- Candle size: 1, 5, 15, 30 or 60 for minutes, D for daily, W for weekly, M for monthly. Some sizes are not available on every exchange. Example: D.one of
15153060DWM symbolstringrequired- Forex pair symbol exactly as returned by finnhub_list_forex_symbols, including the exchange prefix. Example: OANDA:EUR_USD.
tointegerrequired- End of the range as a UNIX timestamp in seconds. Example: 1759276800 (2025-10-01 00:00 UTC). Intraday resolutions return at most one month per call.
finnhub_get_forex_ratesGet exchange rates from one base currency to every other currency.Read-onlyGet Forex Rates
Get exchange rates from one base currency to every other currency. Returns base and quote, a map of currency code to rate (units of that currency per one unit of base). Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_get_forex_rates for currency conversion. Use finnhub_get_forex_candles for one pair's price history.
Inputs
basestring- Base currency as an ISO code. Omit for EUR. Example: USD.
datestring- Date of the rates, YYYY-MM-DD. Omit for the latest rates. Example: 2026-09-30.
finnhub_get_insider_sentimentGet a US company's monthly insider sentiment score.Read-onlyGet Insider Sentiment
Get a US company's monthly insider sentiment score. Returns symbol and data, one entry per month with year, month, change (net shares bought or sold by insiders) and mspr (monthly share purchase ratio, from -100 most negative to 100 most positive). Use finnhub_get_insider_sentiment for a trend of insider buying. Use finnhub_list_insider_transactions for the individual trades.
Inputs
fromstringrequired- Start date of the month range, YYYY-MM-DD. Example: 2026-09-01.
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it. US companies only.
tostringrequired- End date of the month range, YYYY-MM-DD, inclusive. Example: 2026-09-30.
finnhub_get_ipo_calendarList recent and upcoming IPOs in a date range.Read-onlyGet IPO Calendar
List recent and upcoming IPOs in a date range. Returns ipoCalendar, a list of IPOs with symbol, name, date, exchange, status (expected, priced, withdrawn or filed), price or price range, numberOfShares and totalSharesValue. Use finnhub_get_ipo_calendar to see new listings. Use finnhub_get_company_profile once a company trades.
Inputs
fromstringrequired- Start date of the IPO date range, YYYY-MM-DD. Example: 2026-09-01.
tostringrequired- End date of the IPO date range, YYYY-MM-DD, inclusive. Example: 2026-09-30.
finnhub_get_market_holidaysList an exchange's holidays and shortened trading days.Read-onlyGet Market Holidays
List an exchange's holidays and shortened trading days. Returns exchange, timezone and data, a list of holidays with eventName, atDate and tradingHour (the hours traded on a partial day; empty when closed all day). Use finnhub_get_market_holidays to plan around closures. Use finnhub_get_market_status for whether the market is open now.
Inputs
exchangestringrequired- Finnhub exchange code. Example: US; others include L (London), T (Tokyo), HK (Hong Kong).
finnhub_get_market_statusCheck whether a stock exchange is open right now.Read-onlyGet Market Status
Check whether a stock exchange is open right now. Returns exchange, isOpen, session (pre-market, regular, post-market, or null when closed), holiday (the holiday name if closed for one), timezone and t (current UNIX time). Use finnhub_get_market_status for the current open or closed state. Use finnhub_get_market_holidays for upcoming closures.
Inputs
exchangestringrequired- Finnhub exchange code. Example: US (US exchanges); others include L (London), T (Tokyo), HK (Hong Kong), TO (Toronto).
finnhub_get_peersList companies that operate in the same country and sector, industry or sub-industry as a given company.Read-onlyGet Company Peers
List companies that operate in the same country and sector, industry or sub-industry as a given company. Returns a list of ticker symbols, starting with the requested company. Use finnhub_get_peers to find comparable companies, then finnhub_get_quote or finnhub_get_basic_financials to compare them.
Inputs
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
groupingstring- How peers are grouped: sector, industry or subIndustry. Omit for subIndustry, the narrowest. Example: industry.one of
sectorindustrysubIndustry
finnhub_get_price_targetGet the analysts' consensus price target for a company.Read-onlyGet Price Target
Get the analysts' consensus price target for a company. Returns symbol, targetHigh, targetLow, targetMean, targetMedian, numberAnalysts and lastUpdated. Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_get_price_target for where analysts expect the price to go. Use finnhub_get_recommendation_trends for buy, hold and sell counts.
Inputs
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
finnhub_get_quoteGet the latest price quote for a US stock.Read-onlyGet Quote
Get the latest price quote for a US stock. Returns c (current price), d (change), dp (percent change), h and l (day high and low), o (open), pc (previous close) and t (UNIX time of the quote). Covers US stocks; an unknown symbol returns zeros rather than an error. Use finnhub_get_quote for a current price. Use finnhub_get_stock_candles for price history and finnhub_get_basic_financials for ratios and 52-week ranges.
Inputs
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
finnhub_get_recommendation_trendsGet monthly analyst recommendation counts for a company.Read-onlyGet Recommendation Trends
Get monthly analyst recommendation counts for a company. Returns one entry per month with period, strongBuy, buy, hold, sell and strongSell analyst counts, newest first. Use finnhub_get_recommendation_trends for analyst sentiment. Use finnhub_get_price_target for target prices and finnhub_list_upgrades_downgrades for individual rating changes.
Inputs
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
finnhub_get_stock_candlesGet open, high, low, close and volume candles for a stock over a time range.Read-onlyGet Stock Candles
Get open, high, low, close and volume candles for a stock over a time range. Returns parallel arrays o, h, l, c, v and t (UNIX times) plus s, which is ok or no_data. Daily and longer candles are split-adjusted; intraday candles are not, and return at most one month per call. Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_get_stock_candles for price history and charts. Use finnhub_get_quote for the latest price.
Inputs
fromintegerrequired- Start of the range as a UNIX timestamp in seconds. Example: 1756684800 (2025-09-01 00:00 UTC).
resolutionstringrequired- Candle size: 1, 5, 15, 30 or 60 for minutes, D for daily, W for weekly, M for monthly. Some sizes are not available on every exchange. Example: D.one of
15153060DWM symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it.
tointegerrequired- End of the range as a UNIX timestamp in seconds. Example: 1759276800 (2025-10-01 00:00 UTC). Intraday resolutions return at most one month per call.
finnhub_list_company_newsList news articles about one North American company published in a date range.Read-onlyList Company News
List news articles about one North American company published in a date range. Returns articles with headline, summary, source, url, image, category, related tickers, id and datetime (UNIX time), newest first. The free plan covers the last year. Use finnhub_list_company_news for news about one ticker. Use finnhub_list_market_news for general, forex, crypto or merger headlines.
Inputs
fromstringrequired- Start date of the publication range, YYYY-MM-DD. Example: 2026-09-01.
symbolstringrequired- Ticker symbol of the company, as Finnhub lists it (US tickers are plain, e.g. AAPL; other markets use a suffix, e.g. BMW.DE). Use finnhub_search_symbols to find it. North American companies only.
tostringrequired- End date of the publication range, YYYY-MM-DD, inclusive. Example: 2026-09-30.
finnhub_list_countriesList countries with their codes, currency and risk metadata.Read-onlyList Countries
List countries with their codes, currency and risk metadata. Returns a list of countries with country, code2, code3, codeNo, currency, currencyCode, region, subRegion, equityRiskPremium, countryRiskPremium, defaultSpread and a flag logo URL. Use finnhub_list_countries to look up a country's codes or currency.
Inputs
This tool takes no inputs.
finnhub_list_crypto_exchangesList the crypto exchanges Finnhub supports.Read-onlyList Crypto Exchanges
List the crypto exchanges Finnhub supports. Returns a list of exchange names such as BINANCE, COINBASE and KRAKEN. Use finnhub_list_crypto_exchanges to get a valid exchange for finnhub_list_crypto_symbols.
Inputs
This tool takes no inputs.
finnhub_list_crypto_symbolsList the crypto trading pairs available on one exchange.Read-onlyList Crypto Symbols
List the crypto trading pairs available on one exchange. Returns a list of pairs with symbol (e.g. BINANCE:BTCUSDT, used by finnhub_get_crypto_candles), displaySymbol (e.g. BTC/USDT) and description. Large exchanges return thousands of pairs. Use finnhub_list_crypto_symbols to find a pair's Finnhub symbol. Get exchange names from finnhub_list_crypto_exchanges.
Inputs
exchangestringrequired- Crypto exchange name as returned by finnhub_list_crypto_exchanges. Example: COINBASE.
finnhub_list_forex_exchangesList the forex data sources (brokers) Finnhub supports.Read-onlyList Forex Exchanges
List the forex data sources (brokers) Finnhub supports. Returns a list of exchange names such as oanda, fxcm and ic markets. Use finnhub_list_forex_exchanges to get a valid exchange for finnhub_list_forex_symbols.
Inputs
This tool takes no inputs.
finnhub_list_forex_symbolsList the currency pairs available from one forex exchange.Read-onlyList Forex Symbols
List the currency pairs available from one forex exchange. Returns a list of pairs with symbol (e.g. OANDA:EUR_USD, used by finnhub_get_forex_candles), displaySymbol (e.g. EUR/USD) and description. Use finnhub_list_forex_symbols to find a pair's Finnhub symbol. Use finnhub_get_forex_rates for conversion rates. Get exchange names from finnhub_list_forex_exchanges.
Inputs
exchangestringrequired- Forex exchange name as returned by finnhub_list_forex_exchanges. Example: oanda.
finnhub_list_insider_transactionsList insider share transactions from Form 3, 4 and 5 and equivalent filings (US, UK, Canada, Australia, India and major EU markets).Read-onlyList Insider Transactions
List insider share transactions from Form 3, 4 and 5 and equivalent filings (US, UK, Canada, Australia, India and major EU markets). Returns symbol and data, up to 100 transactions with name, share (shares held after), change (positive for buys, negative for sells), transactionPrice, transactionCode, transactionDate and filingDate. Use finnhub_list_insider_transactions for individual insider trades. Use finnhub_get_insider_sentiment for a monthly net buying score.
Inputs
fromstring- Start date of the transaction range, YYYY-MM-DD. Example: 2026-09-01.
symbolstring- Ticker symbol of the company. Omit to get the latest transactions across all companies. Example: TSLA.
tostring- End date of the transaction range, YYYY-MM-DD. Example: 2026-09-30.
finnhub_list_market_newsList the latest market news headlines in one category: general, forex, crypto or merger.Read-onlyList Market News
List the latest market news headlines in one category: general, forex, crypto or merger. Returns articles with headline, summary, source, url, image, category, related tickers, id and datetime (UNIX time), newest first. Use finnhub_list_market_news for broad market headlines. Use finnhub_list_company_news for one company. Pass the highest id you have already seen as min_id to get only newer articles.
Inputs
categorystringrequired- News category: general, forex, crypto or merger. Example: general.one of
generalforexcryptomerger min_idinteger- Return only articles with an id greater than this value, to fetch news newer than what you already have. Omit (or 0) for the latest batch. Example: 7461234.
finnhub_list_sec_filingsList SEC filings for a company, or the latest filings across all companies.Read-onlyList SEC Filings
List SEC filings for a company, or the latest filings across all companies. Returns up to 250 filings with accessNumber, symbol, cik, form (e.g. 10-K, 10-Q, 8-K), filedDate, acceptedDate, reportUrl and filingUrl. Use finnhub_list_sec_filings to find filings and their links. Use finnhub_get_financials_as_reported for the financial data inside 10-K and 10-Q filings.
Inputs
access_numberstring- Accession number of one filing to return. Example: 0000320193-24-000123.
cikstring- SEC Central Index Key of the company, used instead of symbol. Example: 320193.
formstring- Only return this form type. Example: 10-K (use NT 10-K to find late filings).
fromstring- Start date of the filing range, YYYY-MM-DD. Example: 2026-09-01.
symbolstring- Ticker symbol of the company. Omit symbol, cik and access_number to list the latest filings market-wide. Example: AAPL.
tostring- End date of the filing range, YYYY-MM-DD. Example: 2026-09-30.
finnhub_list_stock_symbolsList every stock symbol Finnhub supports on one exchange, optionally filtered by MIC, security type or currency.Read-onlyList Stock Symbols
List every stock symbol Finnhub supports on one exchange, optionally filtered by MIC, security type or currency. Returns a list of securities with symbol, displaySymbol, description, type, mic, figi, shareClassFIGI and currency. The unfiltered US list has tens of thousands of entries and may be too large or slow to return, so narrow it with mic, security_type or currency. Use finnhub_list_stock_symbols to enumerate an exchange. Use finnhub_search_symbols to find one company's ticker.
Inputs
exchangestringrequired- Finnhub exchange code to list. Example: US (all US exchanges); others include L (London), T (Tokyo), TO (Toronto).
currencystring- Only return symbols priced in this currency, as an ISO code. Example: USD.
micstring- Only return symbols whose primary listing is this market identifier code. Example: XNYS (NYSE) or XNAS (Nasdaq).
security_typestring- Only return this OpenFIGI security type. Example: Common Stock (others include ETP, ADR, REIT).
finnhub_list_upgrades_downgradesList analyst rating changes for a company, or the latest across the market.Read-onlyList Upgrades And Downgrades
List analyst rating changes for a company, or the latest across the market. Returns a list of rating changes with symbol, company (the analyst firm), fromGrade, toGrade, action (up, down, main for maintain, init or reit for reiterate) and gradeTime (UNIX time). Needs a paid Finnhub plan; a free key gets an access error (HTTP 403). Use finnhub_list_upgrades_downgrades for individual rating actions. Use finnhub_get_recommendation_trends for monthly totals.
Inputs
fromstring- Start date of the rating change range, YYYY-MM-DD. Example: 2026-09-01.
symbolstring- Ticker symbol of the company. Omit to get the latest rating changes market-wide. Example: AAPL.
tostring- End date of the rating change range, YYYY-MM-DD. Example: 2026-09-30.
finnhub_search_symbolsSearch Finnhub for securities matching a ticker, company name, ISIN or CUSIP.Read-onlySearch Symbols
Search Finnhub for securities matching a ticker, company name, ISIN or CUSIP. Returns count and result, a list of matches with symbol, displaySymbol, description (the security name) and type (e.g. Common Stock, ETP). Use finnhub_search_symbols to turn a company name into a ticker before calling other tools. Use finnhub_list_stock_symbols to list every symbol on one exchange.
Inputs
qstringrequired- Text to search for: a ticker, company name, ISIN or CUSIP. Example: apple.
exchangestring- Limit results to one exchange, by Finnhub exchange code (e.g. US for US exchanges, L for London, T for Tokyo). Omit to search all exchanges. Example: US.
No tools match.
