Finnhub.io

Consume Finnhub.io API

Actions26

Overview

The Finnhub.io node for n8n allows users to interact with the Finnhub financial data API. Specifically, when using the Stock resource and the Quote operation, this node retrieves real-time stock quote information (such as current price, high/low, open/close, etc.) for a specified company symbol. This is useful for workflows that require up-to-date market data, such as monitoring stock prices, triggering alerts based on price changes, or integrating financial data into reports.

Example scenarios:

Automatically fetching the latest price of a stock (e.g., AAPL) at regular intervals.
Building dashboards that display live stock quotes.
Triggering notifications if a stock's price crosses a certain threshold.

Properties

Name	Type	Meaning
Symbol	String	The ticker symbol of the company to fetch the quote 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 output will be a JSON object containing the real-time quote information for the requested stock symbol. Typical fields in the output may include:

{
  "c": 123.45, // Current price
  "h": 125.00, // High price of the day
  "l": 120.50, // Low price of the day
  "o": 122.00, // Open price of the day
  "pc": 121.00, // Previous close price
  "t": 1618300800 // Timestamp
}

Note: The exact structure may vary depending on the Finnhub API response.

Dependencies

Finnhub API Key: You must provide valid Finnhub credentials in n8n (API key).
External Service: Requires internet access to connect to https://finnhub.io/api/v1.

Troubleshooting

Invalid API Key: If your API key is missing or incorrect, you may receive authentication errors. Ensure your Finnhub credentials are correctly configured in n8n.
Symbol Not Found: If an invalid or unsupported symbol is provided, the API may return an error or empty result. Double-check the symbol spelling.
Premium Data Required: Some data may only be available to premium subscribers. If you receive permission errors, check your subscription status and set the "Premium" property accordingly.
Rate Limits: Exceeding Finnhub's rate limits can result in temporary blocks. Monitor your usage and consider upgrading your plan if necessary.