Finnhub.io

Overview

This n8n node interacts with the Finnhub.io API to retrieve stock symbols for a specified exchange. It is designed for users who need to look up or validate stock symbols, particularly when working with financial data automation workflows. Common scenarios include:

• Searching for all available stock symbols on a specific exchange (e.g., "US" for United States).
• Integrating symbol lookup as part of a larger workflow for portfolio management, market analysis, or automated trading.
• Filtering or mapping user input to valid stock symbols before making further API calls.

Practical Example:
A user wants to fetch all stock symbols listed on the NASDAQ exchange to populate a dropdown in a custom dashboard or to cross-reference with their own holdings.

Properties

Output

The output will be a JSON array where each item represents a stock symbol found on the specified exchange. Each object typically contains fields such as:

[
  {
    "symbol": "AAPL",
    "displaySymbol": "AAPL",
    "description": "Apple Inc.",
    "type": "Common Stock"
  },
  ...
]

• symbol: The ticker symbol.
• displaySymbol: The display version of the symbol.
• description: Company or security name.
• type: Security type (e.g., "Common Stock").

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

Dependencies

• External Service: Requires access to the Finnhub.io API.
• API Key: You must configure an API key credential named finnhub in your n8n instance.
• Environment: Internet access from the n8n server to https://finnhub.io/api/v1.

Troubleshooting

• Invalid API Key:
  Error Message: "401 Unauthorized"
  Resolution: Ensure your Finnhub.io API key is correctly configured in n8n credentials.

• Exchange Not Supported:
  Error Message: "Exchange not found" or empty results
  Resolution: Double-check the value entered for "Exchange". Use standard codes like "US", "NASDAQ", etc.

• Premium Features Unavailable:
  Error Message: "Upgrade required" or missing data
  Resolution: Set "Premium" to true only if you have a premium subscription. Some exchanges or data may require premium access.

• Rate Limiting:
  Error Message: "429 Too Many Requests"
  Resolution: Reduce request frequency or upgrade your Finnhub.io plan.

Links and References

• Finnhub.io API Documentation – Stock Symbol Lookup
• n8n Credentials Setup Guide
• List of Supported Exchanges by Finnhub