> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Finnhub

> Finnhub provides real-time market data, company fundamentals, financial news, economic data, and securities reference information.

![Finnhub logo](https://mintcdn.com/composio-preview/r7CO9m4_UWMVFnU7/images/toolkits/finnhub.svg?fit=max\&auto=format\&n=r7CO9m4_UWMVFnU7\&q=85\&s=4a27a057bf2c802e254d21660eeb5827)

* **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

> [accordion] Get Company Financial Metrics
>
> **Slug:** `FINNHUB_GET_COMPANY_FINANCIAL_METRICS`
>
> Get 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **symbol** `string` *required*
>
> Company ticker whose financial metrics should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company Profile
>
> **Slug:** `FINNHUB_GET_COMPANY_PROFILE`
>
> Look up a company profile by exactly one ticker, ISIN, or CUSIP.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.02 per Finnhub API request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **isin** `string`
>
> Company ISIN. Provide exactly one identifier.
>
> **cusip** `string`
>
> Company CUSIP. Provide exactly one identifier.
>
> **symbol** `string`
>
> Company ticker, such as AAPL. Provide exactly one identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Market Status
>
> **Slug:** `FINNHUB_GET_MARKET_STATUS`
>
> Check 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **exchange** `string` *required*
>
> Finnhub exchange code, such as US.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Quote
>
> **Slug:** `FINNHUB_GET_QUOTE`
>
> Get 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **symbol** `string` *required*
>
> Exact Finnhub symbol to quote.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Quotes
>
> **Slug:** `FINNHUB_GET_QUOTES`
>
> Get 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 call
>
> **Discount:** 100
>
> #### Input Parameters
>
> **symbols** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reported Financials
>
> **Slug:** `FINNHUB_GET_REPORTED_FINANCIALS`
>
> Retrieve 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **cik** `string`
>
> SEC Central Index Key used to find reports. Required when neither a ticker nor an accession number is provided.
>
> **symbol** `string`
>
> Company ticker used to find reports. Required when neither CIK nor an accession number is provided.
>
> **to\_date** `string`
>
> Optional report end-date upper bound in YYYY-MM-DD format; provide with from\_date.
>
> **frequency** `string ("annual" | "quarterly")`
>
> Report frequency: annual or quarterly.
>
> **from\_date** `string`
>
> Optional report end-date lower bound in YYYY-MM-DD format; provide with to\_date.
>
> **max\_reports** `integer`
>
> Maximum reports returned by the tool; Finnhub does not paginate this endpoint.
>
> **access\_number** `string`
>
> SEC accession number for one specific report. Required when neither a ticker nor CIK is provided.
>
> **include\_statement\_details** `boolean`
>
> Include full balance-sheet, cash-flow, and income-statement arrays. Leave false for compact report metadata because statement bodies can be large.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Calendar Events
>
> **Slug:** `FINNHUB_LIST_CALENDAR_EVENTS`
>
> List 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **symbol** `string`
>
> Optional earnings ticker filter; unavailable for IPO events.
>
> **to\_date** `string` *required*
>
> End date in YYYY-MM-DD format.
>
> **from\_date** `string` *required*
>
> Start date in YYYY-MM-DD format.
>
> **event\_type** `string ("earnings" | "ipo")` *required*
>
> Calendar dataset to query: earnings releases or IPO events.
>
> **max\_results** `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.
>
> **include\_international** `boolean`
>
> For earnings only, include international markets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Earnings Results
>
> **Slug:** `FINNHUB_LIST_EARNINGS_RESULTS`
>
> List a company's recent actual versus estimated earnings and surprise values.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.02 per Finnhub API request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **symbol** `string` *required*
>
> Company ticker, such as AAPL; must not be blank.
>
> **max\_results** `integer`
>
> Requested and locally enforced result cap. Finnhub may ignore the upstream limit; the free tier currently returns the last four quarters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List SEC Filings
>
> **Slug:** `FINNHUB_LIST_SEC_FILINGS`
>
> List 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **cik** `string`
>
> SEC Central Index Key used to find filings. Required when neither a ticker nor an accession number is provided.
>
> **form** `string`
>
> Optional SEC form filter, such as 10-K or NT 10-K.
>
> **symbol** `string`
>
> Company ticker used to find filings. Required when neither CIK nor an accession number is provided.
>
> **to\_date** `string`
>
> Optional filing-date upper bound in YYYY-MM-DD format; provide with from\_date.
>
> **from\_date** `string`
>
> Optional filing-date lower bound in YYYY-MM-DD format; provide with to\_date.
>
> **max\_results** `integer`
>
> Maximum filings returned by the tool; Finnhub does not paginate this endpoint.
>
> **access\_number** `string`
>
> SEC accession number for one specific filing. Required when neither a ticker nor CIK is provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search News
>
> **Slug:** `FINNHUB_SEARCH_NEWS`
>
> Get 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **min\_id** `integer`
>
> For market news, return updates after this article ID. Use next\_min\_id from a prior untruncated response for incremental polling.
>
> **symbol** `string`
>
> Exact company ticker. Required only when news\_type is company.
>
> **to\_date** `string`
>
> Company-news end date in YYYY-MM-DD format. Required with from\_date when news\_type is company; unavailable for market news.
>
> **category** `string ("general" | "forex" | "crypto" | "merger")`
>
> Market-news category. Required only when news\_type is market.
>
> **from\_date** `string`
>
> Company-news start date in YYYY-MM-DD format. Required with to\_date when news\_type is company; unavailable for market news.
>
> **news\_type** `string ("market" | "company")` *required*
>
> Use market for category news or company for ticker-specific news.
>
> **max\_results** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Symbols
>
> **Slug:** `FINNHUB_SEARCH_SYMBOLS`
>
> Find 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 request
>
> **Discount:** 100
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Ticker, company name, ISIN, or CUSIP to search; must not be blank.
>
> **exchange** `string`
>
> Optional Finnhub exchange code to restrict matches.
>
> **max\_results** `integer`
>
> Maximum matches returned by the tool; Finnhub provides no server-side limit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
