Overview
This node integrates with the StockAlert.pro API to create and 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 more.
Common scenarios include:
- Monitoring a stock's price crossing above or below a certain threshold.
- Receiving notifications when a stock hits new 52-week highs or lows.
- Tracking moving average crossovers (Golden Cross or Death Cross).
- Getting alerts for RSI reaching specific limits or volume changes.
- Being notified about upcoming earnings announcements or dividend dates.
Practical example: A trader wants to be alerted via email when Apple's stock price rises above $150 or when the 50-day moving average crosses above the 200-day moving average, signaling a potential bullish trend.
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: Choose between 50-Day or 200-Day moving average (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 node outputs an array of JSON objects representing the created alert(s). Each object contains the data returned by the StockAlert.pro API for the alert, typically including details such as alert ID, symbol, condition type, notification channel, threshold values, parameters, and status.
No binary data is output 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.
- Proper configuration of the API key credential in n8n is necessary for successful execution.
Troubleshooting
Common issues:
- Missing or invalid API key credential will cause authentication failures.
- Providing an invalid stock symbol or unsupported alert condition may result in API errors.
- Omitting required fields like "Stock Symbol" or "Threshold" for certain alert types can cause request validation errors.
Error messages:
- Authentication errors usually indicate problems with the API key; verify the credential setup.
- Validation errors from the API often specify missing or incorrect parameters; ensure all required properties are correctly filled.
- Network or timeout errors suggest connectivity issues; check internet access and API availability.
Links and References
- StockAlert.pro API Documentation (hypothetical link)
- n8n documentation on Creating Custom Nodes