Finnhub.io

Consume Finnhub.io API

Actions26

Overview

The ETFs Profile [PREMIUM] operation of the Finnhub.io n8n node retrieves detailed profile information about a specific Exchange-Traded Fund (ETF) using its symbol. This is particularly useful for financial analysts, investors, or anyone needing to programmatically access up-to-date ETF data for research, reporting, or automation purposes.

Common scenarios:

Automating portfolio analysis by fetching ETF profiles.
Integrating ETF data into dashboards or reports.
Enriching investment workflows with real-time ETF information.

Example:
A user wants to automatically retrieve and store the profile details of the "ARKK" ETF in their database every day.

Properties

Name	Type	Meaning
Symbol	String	ETF symbol (e.g., ARKK). This identifies which ETF's profile will be retrieved.

Output

The node returns a json object containing the ETF's profile information. The exact structure depends on the Finnhub API response, but typically includes fields such as:

symbol: The ETF's ticker symbol.
name: Full name of the ETF.
exchange: The exchange where the ETF is listed.
category: Category or sector of the ETF.
description: A brief description of the ETF.
country: Country of origin.
currency: Trading currency.
Other relevant metadata provided by Finnhub.

Note:
This node does not output binary data; all data is returned as structured JSON.

Dependencies

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

Troubleshooting

Common issues:

Invalid or missing API key:
If your Finnhub credentials are incorrect or missing, the node will fail to authenticate.
Resolution: Ensure you have set up the Finnhub API key in n8n credentials.
Invalid Symbol:
If the provided ETF symbol does not exist, the API may return an error or empty result.
Resolution: Double-check the symbol for typos or use a valid ETF symbol.
API Rate Limits:
Finnhub enforces rate limits, especially on free plans.
Resolution: Upgrade your Finnhub plan or reduce request frequency.

Error messages you might see:

"401 Unauthorized": Invalid or missing API key.
"404 Not Found": The specified ETF symbol does not exist.
"429 Too Many Requests": Rate limit exceeded.