Actions26
- Stock Actions
- Index Actions
- ETF Actions
- Forex Actions
- Crypto Actions
- Alternative Actions
Overview
The Finnhub.io n8n node allows users to interact with the Finnhub API, a service providing real-time and historical data for stocks, indices, ETFs, forex, cryptocurrencies, and alternative financial data.
For the Stock resource and the Symbol Lookup operation, this node enables users to search for stock symbols by coin ID or contract address. This is particularly useful for workflows that require dynamic symbol resolution based on user input or upstream automation.
Example scenarios:
- Automating the process of finding the correct stock symbol before fetching quotes or company information.
- Integrating with other systems where only partial or ambiguous identifiers are available (e.g., searching "apple" to find AAPL).
- Building investment dashboards that allow users to look up securities by name or contract.
Properties
Name | Type | Meaning |
---|---|---|
Symbol Lookup | String | The search term (coin ID or contract address) used to look up a stock symbol. Example: "apple". |
Premium | Boolean | Indicates whether you have a Premium Subscription for Finnhub.io. Enables access to premium features if set to true. |
Output
The output will be a JSON object containing the results of the symbol lookup from Finnhub. Typically, this includes:
- A list of matching stock symbols with associated metadata such as symbol, display name, type, and possibly exchange information.
Example output:
{
"count": 2,
"result": [
{
"symbol": "AAPL",
"description": "Apple Inc.",
"type": "Common Stock",
"displaySymbol": "AAPL",
"mic": "XNAS"
},
{
"symbol": "APLE",
"description": "Apple Hospitality REIT Inc.",
"type": "REIT",
"displaySymbol": "APLE",
"mic": "XNYS"
}
]
}
Note: The actual structure may vary depending on Finnhub's API response.
If binary data is returned (unlikely for this operation), it would represent downloadable content related to the lookup, but this is not typical for symbol searches.
Dependencies
- Finnhub API Key: You must configure valid Finnhub credentials in n8n. This typically involves setting an API key via the node's credential settings.
- 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 not set or are incorrect, the node will fail with an authentication error. Ensure your API key is valid and correctly configured in n8n.
- No results found: If the search term does not match any known symbols, the result array will be empty. Double-check your input for typos or try broader search terms.
- Premium-only features: If you attempt to access premium data without enabling the "Premium" property or without a premium subscription, you may receive errors or incomplete data.
Common error messages:
401 Unauthorized
: Check your API key configuration.429 Too Many Requests
: You have exceeded the rate limit for your Finnhub plan. Wait and retry later, or upgrade your subscription.400 Bad Request
: The input parameter (e.g., Symbol Lookup) may be invalid or missing.