# StockAlert.pro - Complete Reference

> Real-time stock price alerts and trading notifications platform for individual investors

## Product Overview

StockAlert.pro monitors stock prices in real-time during US market hours and sends instant email or SMS notifications when user-defined conditions are met. The platform supports 1,500+ US stocks (NYSE, NASDAQ) with data from Alpha Vantage.

Company: Adanos Software GmbH (Berlin, Germany)
Founded: 2024
Website: https://stockalert.pro

## Alert Types (23 total, 7 categories)

### Price Alerts
1. **Price rises above** - Alert when stock price crosses above a target price
2. **Price falls below** - Alert when stock price drops below a target price
3. **Price increases by %** - Alert on percentage price increase
4. **Price decreases by %** - Alert on percentage price decrease
5. **New 52-week high** - Alert when stock reaches a new 52-week high
6. **New 52-week low** - Alert when stock reaches a new 52-week low

### Technical Alerts
7. **Golden Cross** - Alert when 50-day MA crosses above 200-day MA (bullish signal)
8. **Death Cross** - Alert when 50-day MA crosses below 200-day MA (bearish signal)
9. **MA Breakout (Bullish)** - Alert when price breaks above a moving average
10. **MA Breakout (Bearish)** - Alert when price breaks below a moving average
11. **RSI Threshold Cross** - Alert when RSI crosses above or below a specified level

### Alternative Data Alerts
12. **Social Buzz** - Premium alert when discussion rises sharply or interest fades across Reddit and X
13. **Insider Transactions** - Alert on SEC-filed insider buys or sells

### Volume Alerts
14. **Volume change** - Alert on unusual volume activity

### Fundamental Alerts
15. **P/E Ratio falls below** - Alert when P/E ratio drops below target
16. **P/E Ratio rises above** - Alert when P/E ratio exceeds target
17. **Forward P/E falls below** - Alert on forward P/E ratio
18. **Forward P/E rises above** - Alert on forward P/E ratio

### Time-Based Alerts
19. **Reminder** - One-time reminder at a specified time
20. **Daily Reminder** - Recurring daily stock check with current price

### Dividend Alerts
21. **Earnings Announcement** - Alert before earnings release dates
22. **Dividend Ex-Date** - Alert before dividend ex-dates
23. **Dividend Payment Date** - Alert before dividend payment dates

## Pricing

### Free Plan
- 5 active Price and Time alerts
- 2 watchlist stocks
- 1 API key (100 requests/hour)
- No credit card required

### Premium Plan
- $19.99/month or $200.00/year
- Unlimited alerts across all 23 alert types
- 100 watchlist stocks
- Unlimited API keys (10,000 requests/hour)
- 50 SMS alerts per month
- Priority support

## API Reference

Base URL: `https://stockalert.pro/api/v1`
Authentication: API key (`X-API-Key`, `Authorization: ApiKey`, or `Authorization: Bearer`) or Bearer JWT
Rate Limit: Basic 100 requests/hour (1 API key), Premium 10,000 requests/hour (unlimited API keys)
OpenAPI Spec: https://stockalert.pro/openapi.yaml

### AI Agent Access

- Dashboard setup: https://app.stockalert.pro/agents
- Remote MCP endpoint: `POST https://stockalert.pro/mcp`
- Transport: Streamable HTTP with JSON responses. GET and DELETE return 405.
- Authentication: OAuth browser login for Claude, ChatGPT, Codex, and Claude Code, or `Authorization: Bearer $STOCKALERT_API_KEY`. OAuth access tokens start with `mcp_at_`. API keys may also be sent as `X-API-Key`.
- OAuth discovery: `GET /.well-known/oauth-protected-resource/mcp` and `GET /.well-known/oauth-authorization-server`. Scopes: `alerts:read`, `alerts:write`, `watchlist:read`, `watchlist:write`.
- Tools: `list_alerts`, `get_alert`, `list_alert_events`, `create_alert`, `update_alert`, `pause_alert`, `resume_alert`, `delete_alert`, `list_watchlist`, `create_watchlist_item`, `delete_watchlist_item`
- `list_alert_events` returns fired alert history. Poll at most once per minute. Drain `meta.cursor.next_cursor` until `has_more` is false, then set `since` to the newest `action_timestamp`. Omit `since` on the first call and treat that page as already seen. Basic keys share 100 requests/hour across all MCP tools.
- `delete_alert` and `delete_watchlist_item` are destructive and require `confirm: true` for the exact ID
- The server enforces account ownership, OAuth or API-key scopes, rate limits, plan limits, and validation
- Fired alerts are not pushed into the MCP session. Use `alert.triggered` webhooks for push delivery.

### Endpoints

**Alerts**
- `GET /alerts` - List all alerts
- `POST /alerts` - Create a new alert
- `GET /alerts/{id}` - Get alert details
- `PUT /alerts/{id}` - Update an alert
- `DELETE /alerts/{id}` - Delete an alert
- `POST /alerts/{id}/pause` - Pause an alert
- `POST /alerts/{id}/activate` - Activate an alert
- `GET /alerts/history` - List alert history events
- `GET /alerts/{id}/history` - Get alert history

**Watchlist**
- `GET /watchlist` - List watchlist items
- `POST /watchlist` - Add stock to watchlist
- `PATCH /watchlist/{id}` - Update watchlist item
- `DELETE /watchlist/{id}` - Remove watchlist item
- `POST /watchlist/order` - Reorder watchlist items
- `GET /watchlist/paper-trades` - Get watchlist paper trades
- `GET /watchlist/performance` - Get watchlist performance

**Stocks**
- `GET /stocks/{symbol}` - Get stock details with price and fundamentals

**Webhooks**
- `GET /webhooks` - List webhooks
- `POST /webhooks` - Register a webhook endpoint
- `GET /webhooks/{id}` - Get webhook details
- `DELETE /webhooks/{id}` - Remove a webhook
- `POST /webhooks/test` - Send test webhook event

**Account**
- `GET /user/subscription` - Get current subscription and quota usage

### SDKs

**JavaScript/TypeScript**
- Package: `@stockalert/sdk` (npm)
- Version: 2.1.2
- Repository: https://github.com/stockalert-pro/js-sdk

**Python**
- Package: `stockalert` (PyPI)
- Version: 2.0.4
- Repository: https://github.com/stockalert-pro/python-sdk

**n8n**
- Package: `n8n-nodes-stockalert` (npm)
- Version: 1.0.1
- Repository: https://github.com/stockalert-pro/n8n-nodes-stockalert

## Features

- Real-time price monitoring during US market hours (9:30 AM - 4:00 PM ET)
- Email and SMS notification channels
- Remote MCP for Claude, ChatGPT, Codex, and Claude Code (OAuth or API key)
- AI-powered stock analysis (1,000-word equity reports per stock)
- Daily stock newsletter (free, no signup required)
- Dividend calendar with ex-date tracking
- Billionaire portfolio tracker (13F filings)
- Stock performance comparison tool
- Undervalued stock screener (P/E ratio based)
- 22 educational investment guides

## Guides (22 articles)

Topics covered: RSI, MACD, Bollinger Bands, Moving Averages, Stochastic Oscillator, Support & Resistance, P/E Ratio, Dividend Investing, Options Trading, Risk Management, Sector Analysis, Growth vs Value, Short Selling, Swing Trading, Trend Trading, Financial Statements, Financial Formulas, Market Psychology, Economic Indicators, Small Cap vs Large Cap, Exit Strategies, Platform Comparison.

## Contact

- Support: info@stockalert.pro
- Business: contact@stockalert.pro
- Twitter/X: @StockAlertX
- GitHub: github.com/stockalert-pro