Overview
This node integrates with the StockAlert.pro API to manage stock market alerts. Specifically, the "Alert" resource with the "Create" operation allows users to set up various types of stock alerts based on price movements, technical indicators, earnings announcements, dividends, and other financial metrics.
Common scenarios include:
- Notifying when a stock price crosses above or below a certain threshold.
- Alerting on percentage changes in price or volume.
- Receiving reminders or notifications about earnings announcements or dividend dates.
- Monitoring technical analysis signals like moving average crossovers or RSI limits.
Practical example: A trader wants to be notified via email when Apple's stock price rises above $150 or when the 50-day moving average crosses above the 200-day moving average (a "Golden Cross"). This node can create such alerts automatically.
Properties
| Name | Meaning |
|---|---|
| Alert Type | Type of alert to create. Options include: Price Above, Price Below, Price Change Up (%), Price Change Down (%), New 52-Week High, New 52-Week Low, One-Time Reminder, Daily Reminder, Golden Cross (MA), Death Cross (MA), MA Touch Above, MA Touch Below, RSI Limit, Volume Change, P/E Ratio Below, P/E Ratio Above, Forward P/E Below, Forward P/E Above, Earnings Announcement, Dividend Ex-Date, Dividend Payment. |
| Alert Configuration | Collection of settings to configure the alert: • MA Period: 50-Day MA or 200-Day MA (shown only for MA Touch Above/Below alerts) • Notification Channel: Email or SMS • RSI Direction: Above or Below (shown only for RSI Limit alert) • Stock Symbol: The ticker symbol of the stock (e.g., AAPL) • Threshold: Numeric target value for alerts that require it (price, volume change, RSI limit, P/E ratios, etc.) |
Output
The output is a JSON array where each item corresponds to an alert created by the node. Each alert object contains data returned from the StockAlert.pro API representing the newly created alert, including its ID, condition, symbol, notification channel, threshold, parameters, and other metadata.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the StockAlert.pro API.
- The node uses HTTP requests to communicate with the StockAlert.pro service endpoints.
- No additional environment variables are required beyond the API authentication setup.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication errors.
- Providing an invalid stock symbol or unsupported alert condition may result in API validation errors.
- Omitting required fields like the stock symbol or threshold (when applicable) can cause request failures.
Error messages:
- Authentication errors typically indicate problems with the API key; verify the credential configuration.
- Validation errors from the API will specify which parameter is missing or invalid; ensure all required properties are correctly set.
- Network or connectivity issues may cause timeouts or failed requests; check internet connection and API availability.
Links and References
- StockAlert.pro API Documentation (hypothetical link)
- n8n documentation on Creating Custom Nodes