- 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
Get Company Financial Metrics
Get Company Financial Metrics
Get Company Profile
Get Company Profile
Get Market Status
Get Market Status
Get Quote
Get Quote
Get Quotes
Get Quotes
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: 100Input Parameters
One to 10 unique Finnhub symbols to quote. The tool makes one upstream request per symbol and preserves this order in the results.
Output
Get Reported Financials
Get Reported Financials
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: 100Input Parameters
SEC Central Index Key used to find reports. Required when neither a ticker nor an accession number is provided.
Company ticker used to find reports. Required when neither CIK nor an accession number is provided.
SEC accession number for one specific report. Required when neither a ticker nor CIK is provided.
Include full balance-sheet, cash-flow, and income-statement arrays. Leave false for compact report metadata because statement bodies can be large.
Output
List Calendar Events
List Calendar Events
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: 100Input Parameters
Maximum events returned by the tool. This local cap does not reduce Finnhub’s upstream payload, so use a ticker or narrow date range.
Output
List Earnings Results
List Earnings Results
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: 100Input Parameters
Requested and locally enforced result cap. Finnhub may ignore the upstream limit; the free tier currently returns the last four quarters.
Output
List SEC Filings
List SEC Filings
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: 100Input Parameters
SEC Central Index Key used to find filings. Required when neither a ticker nor an accession number is provided.
Company ticker used to find filings. Required when neither CIK nor an accession number is provided.
SEC accession number for one specific filing. Required when neither a ticker nor CIK is provided.
Output
Search News
Search News
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: 100Input Parameters
For market news, return updates after this article ID. Use next_min_id from a prior untruncated response for incremental polling.
Company-news end date in YYYY-MM-DD format. Required with from_date when news_type is company; unavailable for market news.
Market-news category. Required only when news_type is market.
Company-news start date in YYYY-MM-DD format. Required with to_date when news_type is company; unavailable for market news.
Use market for category news or company for ticker-specific news.
Maximum articles returned by the tool. This local cap does not reduce Finnhub’s company-news payload, so prefer narrow company date ranges.