Finnhub.io icon

Finnhub.io

Consume Finnhub.io API

Overview

This n8n node integrates with the Finnhub.io API to provide stock-related data. In the context of the Stock resource and its Default operation, the node is designed to fetch stock market information from Finnhub.io. This can be useful for workflows that require real-time or historical stock data, such as financial dashboards, automated trading strategies, or alerting systems.

Practical examples:

  • Retrieve current stock prices for a list of tickers.
  • Integrate stock data into reports or notifications.
  • Enrich CRM records with up-to-date stock information.

Properties

Name Type Meaning
Premium Boolean Whether you have a Premium Subscription for Finnhub.io. Set to true if you are a premium user to unlock additional features or higher rate limits.

Output

The node outputs a json field containing the response from the Finnhub.io API for the requested stock data. The exact structure depends on the specific stock endpoint called, but typically includes fields such as:

  • Stock symbol
  • Price information (current, open, high, low, close)
  • Volume
  • Timestamps

Note: If the node supports binary output (e.g., for chart images), it will be included as a binary property, representing the downloaded file or image.

Dependencies

  • External Service: Requires access to the Finnhub.io API.
  • API Key: You must configure an API key for Finnhub.io in n8n credentials under the name finnhub.
  • n8n Configuration: No special environment variables beyond the Finnhub API key are required.

Troubleshooting

Common Issues:

  • Invalid API Key: If your API key is missing or incorrect, the node will fail with an authentication error. Ensure your Finnhub credential is set up correctly in n8n.
  • Rate Limits: Free accounts on Finnhub.io have strict rate limits. If you exceed these, you may receive errors indicating too many requests.
  • Premium Features: Some endpoints or data may only be available to premium users. If you attempt to access these without setting "Premium" to true (and having a premium account), you may get permission errors.

Error Messages:

  • 401 Unauthorized: Check your API key configuration.
  • 429 Too Many Requests: Reduce request frequency or upgrade to a premium plan.
  • 403 Forbidden: Attempted to access premium-only data without proper subscription.

Links and References

Discussion