Tools reference · Alerts and watchlists

Add a price alert

Action create_price_alert 5 credits a call

Adds a price alert in Senntric for when a ticker crosses above, crosses below or touches a price. It fires in Senntric like an alert you set on a chart.

What it does

By default a cross fires on the first trade through the price. You can ask it to wait for a 5-minute, 15-minute or 1-hour candle to close past the price instead.

This tool makes a change

It changes something in your Senntric account. It needs the “Make changes” permission when you connect, and your AI app asks you to confirm before it runs. It can’t place an order at your broker.

Inputs

symbol Requiredtext. The ticker, such as NVDA.
price Requiredpositive number. The price to watch.
when Requiredone of crosses_above, crosses_below, touches. "crosses_above", "crosses_below" or "touches".
confirm_on_close Optionalone of 5m, 15m, 1h. For crosses only. Wait for a 5m, 15m or 1h candle to close past the price before firing.
repeat Optionaltrue or false. True to fire every time, false (the default) to fire once.
expires_at Optionaldate and time (ISO 8601). The date and time the alert stops, such as 2026-11-30T21:00:00Z. Leave it out for no end date.

Example

You ask

“Alert me if NVDA closes above 185 on the 15-minute chart.”

Result (trimmed, example values)
{
  "created": true,
  "alert": {
    "id": "pa_3fK9xQ",
    "symbol": "NVDA",
    "when": "crosses_above",
    "price": 185,
    "confirm": "15m close",
    "repeat": false,
    "status": "active",
    "expires_at": null
  }
}

Your AI reads this result and answers in plain words. Most results include an open_in_senntric link to see the same thing in Senntric.

See all tools, example prompts and limits and credits.

Updated November 17, 2026. Education, not investment advice.