Finnhub.io

Consume Finnhub.io API

Actions26

Overview

This node interacts with the Finnhub.io API to retrieve a list of available Forex symbols from a specified exchange. It is useful for workflows that require up-to-date lists of tradable currency pairs, such as automated trading bots, financial dashboards, or data enrichment processes.

Example scenarios:

Fetching all available Forex pairs from OANDA to populate dropdowns in custom applications.
Validating if a specific currency pair exists on a given exchange before placing trades.
Building a monitoring tool that tracks new Forex pairs as they become available.

Properties

Name	Type	Meaning
Exchange	String	Exchange you want to get the list of symbols from (e.g., "oanda").

Output

The node outputs a JSON array where each item represents a Forex symbol available on the specified exchange. Each object typically contains fields such as the symbol code and possibly additional metadata (such as base/quote currencies), depending on the Finnhub API response.

Example output:

[
  {
    "symbol": "EUR/USD",
    "displaySymbol": "EUR/USD",
    "description": "Euro / US Dollar"
  },
  {
    "symbol": "GBP/USD",
    "displaySymbol": "GBP/USD",
    "description": "British Pound / US Dollar"
  }
]

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

Dependencies

External Service: Requires access to the Finnhub.io API.
API Key: You must provide a valid Finnhub API key via n8n credentials named finnhub.
n8n Configuration: No special configuration beyond setting up the credential.

Troubleshooting

Missing or Invalid API Key:
Error message: "401 Unauthorized" or similar.
Resolution: Ensure your Finnhub API key is correctly set up in n8n credentials.
Invalid Exchange Value:
Error message: "Exchange not supported" or empty results.
Resolution: Double-check the exchange name (e.g., "oanda") and ensure it is supported by Finnhub.
API Rate Limits:
Error message: "429 Too Many Requests".
Resolution: Wait before making more requests or upgrade your Finnhub plan.