Finnhub.io icon

Finnhub.io

Consume Finnhub.io API

Actions51

Stock → Stock Earnings

AI-generated

Overview

This node interacts with the Finnhub.io API to retrieve stock earnings data for a specified company symbol. It supports both free and premium access to the API, allowing users to fetch earnings history with optional limits on the number of periods returned. This node is useful for financial analysts, investors, or developers who want to integrate stock earnings data into their workflows or applications.

Use Case Examples

  1. Fetch earnings data for Apple Inc. (AAPL) to analyze quarterly performance trends.
  2. Retrieve limited earnings periods for a stock to display recent financial results in a dashboard.

Properties

Name Meaning
Premium Access Toggle to use premium Finnhub endpoints based on the user's credential.
Symbol The stock symbol of the company to retrieve earnings for, e.g., AAPL.
Limit Optional limit on the number of earnings periods returned; leave blank to get full history.
Request Options Advanced request settings including batching, SSL certificate handling, proxy configuration, and timeout settings.

Output

JSON

  • symbol - The stock symbol for which earnings data is retrieved.
  • earnings - Array of earnings data objects containing details such as earnings date, actual earnings, estimated earnings, and other relevant financial metrics.

Dependencies

  • Finnhub.io API access with an API key credential

Troubleshooting

  • Ensure the API key credential is correctly configured and has the necessary permissions for premium endpoints if 'Premium Access' is enabled.
  • If the node returns no data, verify that the stock symbol is correct and that the Finnhub API service is operational.
  • Timeout errors may occur if the API response is slow; adjust the 'Timeout' setting in 'Request Options' accordingly.
  • SSL certificate errors can be bypassed by enabling 'Ignore SSL Issues' but use this with caution as it may expose security risks.

Links

Discussion