Finnhub.io icon

Finnhub.io

Consume Finnhub.io API

Actions26

Overview

The Finnhub.io node for n8n allows you to interact with the Finnhub financial data API. Specifically, when using the Stock resource and the Company Profile 2 operation, this node retrieves detailed company profile information (such as name, industry, website, and more) for a given stock symbol. This is useful in workflows where you need to enrich datasets with up-to-date company information, automate investment research, or build dashboards that display company fundamentals.

Example scenarios:

  • Automatically fetching company details for a list of stock symbols.
  • Enriching CRM records with company profile data.
  • Building custom financial analytics tools or reports.

Properties

Name Type Meaning
Symbol String The stock ticker symbol used to identify the company (e.g., "AAPL" for Apple Inc.).
Premium Boolean Indicates whether you have a Premium Subscription for Finnhub.io, which may affect data access or limits.

Output

The output will be a JSON object containing the company profile information for the specified symbol. Typical fields may include:

{
  "country": "US",
  "currency": "USD",
  "exchange": "NASDAQ",
  "ipo": "1980-12-12",
  "marketCapitalization": 2235173,
  "name": "Apple Inc",
  "phone": "14089961010",
  "shareOutstanding": 4375.47998046875,
  "ticker": "AAPL",
  "weburl": "https://www.apple.com/",
  "logo": "https://static.finnhub.io/logo/2b6f7c9d-4a1b-11ea-b77f-00000000092a.png",
  "finnhubIndustry": "Technology"
}

Note: The actual fields returned depend on the Finnhub API response.

Dependencies

  • Finnhub.io API Key: You must configure your n8n instance with valid Finnhub credentials (API key).
  • n8n Credentials: The node requires a credential named finnhub to be set up in n8n.

Troubleshooting

  • Invalid or Missing API Key:
    Error message: "401 Unauthorized" or similar.
    Resolution: Ensure your Finnhub API key is correctly configured in n8n credentials.

  • Invalid Symbol:
    Error message: "Symbol not found" or empty result.
    Resolution: Double-check the stock symbol for typos or use a valid, supported ticker.

  • Premium Data Required:
    Error message: "Premium subscription required" or missing fields.
    Resolution: Set the "Premium" property to true if you have a premium subscription, or upgrade your Finnhub plan.

  • API Rate Limits:
    Error message: "Too many requests" or HTTP 429.
    Resolution: Wait before making more requests, or consider upgrading your Finnhub plan.

Links and References

Discussion