Create alert
create_alertCreate a price alert, an event alert, a clock, or a trailing alert.
Calling this stores the alert. A clock may omit the ticker.
Args:
symbol: Stock symbol (e.g. "AAPL"). Required for price and event alerts. Optional for a clock.
alert_type: "target_price", "movement_pct", "event", "schedule", or "trailing"
direction: For price alerts: "above", "below", or "either". For trailing: "long" or "short".
Long trails the high since arming; short trails the low. Fires when price gives
back trail_pct percent or trail_amount from that extreme.
threshold: Required for price alerts — price level or percentage move. Not used for trailing.
notes: Optional description. Not the agent instruction.
event_types: Required when alert_type is "event". Live-tape ids such as
filing_13f, politician_senate, options_unusual, ipo_upcoming.
event_filters: Optional slices. Example: {"politician_senate": {"type": ["purchase"]}}.
An omitted field matches every value.
name: Optional title. Blank is filled from the rule.
agent_instruction: What the agent does when this fires. Empty means notify only.
max_fires: How many fires before it leaves Active. Omit to keep a repeating alert firing.
schedule_at: ISO time. Required when alert_type is "schedule".
schedule_tz: IANA zone. UTC when omitted.
schedule_repeat: once, daily, weekdays, weekly, or monthly. Default once.
skill_id: Strategy id this alert belongs to. Required when rule_ref is set.
rule_ref: The section tag of the strategy rule this alert serves; the agent
reads that section when the alert fires (STRATEGY_ALERTS=1).
off_hours: "defer" (wake at next session open) or "now" (act while closed).
Used when ALERT_OFF_HOURS=1 and the alert has an agent instruction.
trail_pct: Trailing give-back percent (0 < x <= 50). Exactly one of trail_pct or trail_amount.
trail_amount: Trailing give-back absolute amount (> 0). Exactly one of trail_pct or trail_amount.
activate_at: Optional price that must be reached before trailing starts.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_alert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| notes | No | ||
| symbol | No | ||
| rule_ref | No | ||
| skill_id | No | ||
| direction | No | ||
| max_fires | No | ||
| off_hours | No | ||
| threshold | No | ||
| trail_pct | No | ||
| alert_type | No | ||
| activate_at | No | ||
| event_types | No | ||
| schedule_at | No | ||
| schedule_tz | No | ||
| strategy_id | No | Strategy this call belongs to. UUID from list_strategies. The card this call writes keeps that id. Omit when the call is not part of a strategy. | |
| trail_amount | No | ||
| event_filters | No | ||
| schedule_repeat | No | ||
| agent_instruction | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |