Watchlists and Alerts
Create and manage watchlists, and set price alerts. Ask your AI client in plain language; it picks the tool.
create_watchlist
Create a new watchlist with optional initial symbols. Use to set up new watchlists for tracking specific stocks, sectors, or trading strategies.
Example prompts
- “Create a watchlist called Banking.”
- “Create a watchlist called IT with TCS, INFY and WIPRO.”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
watchlist_name | string | yes | Name of the watchlist to create |
delete_watchlist
Delete an existing watchlist using watchlist id, if watchlist id is not provided then fetch all watchlists and use the watchlist name to find the watchlist id and delete the watchlist using ID
Example prompts
- “Delete my watchlist called Test.”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
watchlist_ids | array | yes | List of watchlist IDs to delete (obtained from list_watchlist) |
get_watchlists
Get all user watchlists with their symbols and details. Use to display watchlist overview, show watchlist contents, check watchlist status, and manage multiple watchlists.
Example prompts
- “Show all my watchlists.”
get_watchlists_by_id
Get detailed information about a specific watchlist including all symbols with their live market data (LTP, change, change percent, 52-week high/low, description, etc.). Use to view watchlist contents, analyze stocks in a watchlist, get symbol details, and monitor watchlist performance. If watchlist_id is not available, first call get_watchlists to retrieve all watchlist IDs.
Example prompts
- “Show the stocks in my Banking watchlist with today’s change.”
- “Which stock in my IT watchlist is closest to its 52-week high?”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
watchlist_id | string | yes | The ID of the watchlist to get (obtained from the ‘lut’ field in get_watchlists response) |
add_symbols_to_watchlist
Add symbols to an existing watchlist. Use to expand watchlists with new stocks, add symbols for tracking, or update watchlist contents.
Example prompts
- “Add TCS and INFY to my IT watchlist.”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | yes | List of stock symbols/symboltickers to add to watchlist. Symbols are obtained from indus server and symbol tickers are obtained from financial screener server |
watchlist_id | string | yes | The ID of the watchlist to add the symbols to |
watchlist_name | string | yes | The name of the watchlist |
remove_symbols_from_watchlist
Remove one or more symbols from an existing watchlist. The tool will verify which symbols exist in the watchlist before attempting removal and provide detailed information about which symbols were removed and which were not found.
Example prompts
- “Remove SBIN from my Banking watchlist.”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | yes | List of stock symbols to remove from the watchlist |
watchlist_id | string | yes | The ID of the watchlist to remove the symbols from |
watchlist_name | string | yes | The name of the watchlist |
create_price_alert
Create price alerts for stocks that trigger notifications when market conditions are met. Use for watchlist alerts, breakout/breakdown monitoring, volume alerts, and percentage change notifications.
Example prompts
- “Alert me when RELIANCE crosses 3,000.”
- “Create an alert if NIFTY 50 falls below 23,500.”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
comparisonType | string | yes | Market data field to compare: LTP, HIGH, LOW, OPEN, VOLUME TRADED TODAY, DAY CHANGE, DAY CHANGE PERCENT, TOTAL BUY QUANTITY, TOTAL SELL QUANTITY, AVERAGE TRADE PRICE, INTRA DAY CHANGE, INTRA DAY CHANGE PERCENT |
condition | string | yes | Comparison condition: E (Equal), GT (Greater Than), GTE (Greater Than or Equal), LT (Less Than), LTE (Less Than or Equal) |
name | string | yes | Alert name/identifier |
symbol | string | yes | Trading symbol (e.g., NSE:SBIN-EQ) |
value | number | yes | Alert trigger value |
delete_price_alert
Delete a specific price alert by alert ID. Use to remove unwanted alerts and manage notification settings.
Example prompts
- “Delete my RELIANCE price alert.”
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
alertId | string | yes | Alert ID to delete |
get_price_alerts
Get all active price alerts that notify when stocks reach specific price levels or market conditions. Use to display active alerts, check trigger conditions, monitor alert status, and manage notification preferences.
Example prompts
- “Show my active price alerts.”