Skip to main content
Finnhub logo
  • Category: market data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: FINNHUB
  • Version: 20261014_01
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: FINNHUB_GET_COMPANY_FINANCIAL_METRICSGet Finnhub’s current key ratios and annual or quarterly metric series for one company.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
required
Company ticker whose financial metrics should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_GET_COMPANY_PROFILELook up a company profile by exactly one ticker, ISIN, or CUSIP.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
Company ISIN. Provide exactly one identifier.
string
Company CUSIP. Provide exactly one identifier.
string
Company ticker, such as AAPL. Provide exactly one identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_GET_MARKET_STATUSCheck whether an exchange is open now and identify its current session, timezone, or holiday.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
required
Finnhub exchange code, such as US.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_GET_QUOTEGet the latest price snapshot for one Finnhub symbol. Unknown symbols fail explicitly instead of returning a misleading zero quote.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
required
Exact Finnhub symbol to quote.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_GET_QUOTESGet price snapshots for 1-10 Finnhub symbols in one tool call. This uses one Finnhub API request per symbol and reports unrecognized symbols per result.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API request; 1-10 requests ($0.02-$0.2) per tool callDiscount: 100

Input Parameters

array
required
One to 10 unique Finnhub symbols to quote. The tool makes one upstream request per symbol and preserves this order in the results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_GET_REPORTED_FINANCIALSRetrieve as-reported balance-sheet, cash-flow, and income-statement data for a company or filing. A ticker, CIK, or accession number is required; large statement details are available only when requested.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
SEC Central Index Key used to find reports. Required when neither a ticker nor an accession number is provided.
string
Company ticker used to find reports. Required when neither CIK nor an accession number is provided.
string
Optional report end-date upper bound in YYYY-MM-DD format; provide with from_date.
string ("annual" | "quarterly")
Report frequency: annual or quarterly.
string
Optional report end-date lower bound in YYYY-MM-DD format; provide with to_date.
integer
Maximum reports returned by the tool; Finnhub does not paginate this endpoint.
string
SEC accession number for one specific report. Required when neither a ticker nor CIK is provided.
boolean
Include full balance-sheet, cash-flow, and income-statement arrays. Leave false for compact report metadata because statement bodies can be large.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_LIST_CALENDAR_EVENTSList earnings releases or IPO events in an ordered date range. Use an earnings ticker or a narrow date window because Finnhub does not paginate or server-limit these calendars.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
Optional earnings ticker filter; unavailable for IPO events.
string
required
End date in YYYY-MM-DD format.
string
required
Start date in YYYY-MM-DD format.
string ("earnings" | "ipo")
required
Calendar dataset to query: earnings releases or IPO events.
integer
Maximum events returned by the tool. This local cap does not reduce Finnhub’s upstream payload, so use a ticker or narrow date range.
boolean
For earnings only, include international markets.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_LIST_EARNINGS_RESULTSList a company’s recent actual versus estimated earnings and surprise values.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
required
Company ticker, such as AAPL; must not be blank.
integer
Requested and locally enforced result cap. Finnhub may ignore the upstream limit; the free tier currently returns the last four quarters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_LIST_SEC_FILINGSList SEC filing metadata; a ticker, CIK, or accession number is required, optionally filtered by form and an ordered date range.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
SEC Central Index Key used to find filings. Required when neither a ticker nor an accession number is provided.
string
Optional SEC form filter, such as 10-K or NT 10-K.
string
Company ticker used to find filings. Required when neither CIK nor an accession number is provided.
string
Optional filing-date upper bound in YYYY-MM-DD format; provide with from_date.
string
Optional filing-date lower bound in YYYY-MM-DD format; provide with to_date.
integer
Maximum filings returned by the tool; Finnhub does not paginate this endpoint.
string
SEC accession number for one specific filing. Required when neither a ticker nor CIK is provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_SEARCH_NEWSGet broad market news by category or company-specific news for an ordered date range. Use narrow company date ranges because Finnhub does not paginate or server-limit company news.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub news API requestDiscount: 100

Input Parameters

integer
For market news, return updates after this article ID. Use next_min_id from a prior untruncated response for incremental polling.
string
Exact company ticker. Required only when news_type is company.
string
Company-news end date in YYYY-MM-DD format. Required with from_date when news_type is company; unavailable for market news.
string ("general" | "forex" | "crypto" | "merger")
Market-news category. Required only when news_type is market.
string
Company-news start date in YYYY-MM-DD format. Required with to_date when news_type is company; unavailable for market news.
string ("market" | "company")
required
Use market for category news or company for ticker-specific news.
integer
Maximum articles returned by the tool. This local cap does not reduce Finnhub’s company-news payload, so prefer narrow company date ranges.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FINNHUB_SEARCH_SYMBOLSFind tradable symbols by ticker, company name, ISIN, or CUSIP, optionally restricted to an exchange.Instant: Supported on the latest version.Instant pricing: $0.02 per Finnhub API requestDiscount: 100

Input Parameters

string
required
Ticker, company name, ISIN, or CUSIP to search; must not be blank.
string
Optional Finnhub exchange code to restrict matches.
integer
Maximum matches returned by the tool; Finnhub provides no server-side limit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not