Finnhub.io

Consume Finnhub.io API

Actions26

Overview

The Finnhub.io node for n8n allows users to interact with the Finnhub financial data API. When configured with the Stock resource and the Recommendation Trends operation, this node retrieves analyst recommendation trends for a specified stock symbol (e.g., AAPL for Apple Inc.). This is useful for workflows that require up-to-date market sentiment or analyst consensus data, such as automated investment dashboards, alerting systems, or research tools.

Example use cases:

Automatically fetch and log analyst recommendations for a portfolio of stocks.
Trigger alerts when recommendation trends change significantly for a watched symbol.
Enrich CRM or reporting systems with current market sentiment data.

Properties

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

Output

The node outputs a json object containing the analyst recommendation trends for the specified stock symbol. The structure typically includes fields such as:

{
  "symbol": "AAPL",
  "buy": 10,
  "hold": 5,
  "sell": 1,
  "strongBuy": 7,
  "strongSell": 0,
  "period": "2024-06"
}

symbol: The stock symbol queried.
buy, hold, sell, strongBuy, strongSell: Number of analysts with each recommendation.
period: The time period for the trend data.

Note: The exact output fields depend on the Finnhub API response for the Recommendation Trends endpoint.

Dependencies

Finnhub API Key: You must configure valid Finnhub credentials in n8n (API key required).
Finnhub Account: Some features or higher request limits may require a premium subscription (controlled by the "Premium" property).

Troubleshooting

Invalid API Key / Authentication Error:
Error message: "401 Unauthorized" or similar.
Resolution: Ensure your Finnhub API key is correctly set up in n8n credentials.
Symbol Not Found:
Error message: "Symbol not found" or empty results.
Resolution: Double-check the symbol spelling and ensure it exists on Finnhub.
Premium Data Required:
Error message: "Premium subscription required" or limited data returned.
Resolution: Set the "Premium" property to true if you have a premium account, or upgrade your Finnhub plan.
Rate Limits Exceeded:
Error message: "429 Too Many Requests".
Resolution: Wait before making more requests or upgrade your Finnhub plan for higher limits.