Finnhub.io icon

Finnhub.io

Consume Finnhub.io API
Join our community

Actions26

Overview

The Finnhub.io n8n node allows you to interact with the Finnhub financial data API. When configured with the Stock resource and the Peers operation, this node retrieves a list of peer companies (competitors) for a given stock symbol. This is useful for financial analysis, market research, or building dashboards that compare a company with its industry peers.

Example scenarios:

  • Displaying a company's competitors on a dashboard.
  • Automating reports that include peer comparisons for investment decisions.
  • Enriching CRM records with competitor information for sales intelligence.

Properties

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

Output

  • The output will be a JSON array containing the symbols of peer companies for the specified stock symbol.
  • Example output:
{
  "json": {
    "peers": ["MSFT", "GOOGL", "AMZN"]
  }
}
  • No binary data is produced by this operation.

Dependencies

  • Finnhub API Key: You must configure valid Finnhub credentials in n8n (API key required).
  • n8n Configuration: Ensure the Finnhub credential is set up and selected in your workflow.

Troubleshooting

  • Invalid or missing API key:
    Error message: "401 Unauthorized" or similar.
    Resolution: Check that your Finnhub API key is correctly entered in n8n credentials.

  • Invalid Symbol:
    Error message: "Symbol not found" or empty result.
    Resolution: Verify the stock symbol is correct and supported by Finnhub.

  • Premium Data Required:
    Error message: "Premium subscription required" or incomplete data.
    Resolution: Set the "Premium" property to true if you have a premium subscription, or obtain one if needed.

Links and References

Discussion