SimpleFunctions Developer Manual

The watchlist + alerts system has three layers:

Watched objects — what you’re tracking (ticker, query, URL, text).
Alert rules — conditions on watched objects (price_above, price_below, econ_release, gov_action, semantic_match).
Webhook endpoints — where alerts get delivered.

Add to watchlist

sf watchlist add KXRATECUT-26DEC31
sf watchlist identify "Will the Fed cut rates by July?" --json
sf watchlist list --json

identify resolves a free-text query, URL, or ticker into a canonical watched object. The CLI handles dedupe and lifecycle.

Create an alert rule

sf alerts create \
  --object <watched-object-id> \
  --condition price_above \
  --threshold 65 \
  --channel webhook \
  --endpoint <webhook-endpoint-id>

Conditions:

Condition	Trigger
`price_above`	Yes price ≥ threshold (cents)
`price_below`	Yes price ≤ threshold (cents)
`econ_release`	FRED series prints (e.g., CPI release)
`gov_action`	Bill / nomination / treaty status change
`semantic_match`	LLM-classified content match

Each rule is active, paused, or archived. Test with sf alerts test <id>.

Register a webhook endpoint

sf webhooks create \
  --url https://your.app/sf-alerts \
  --label "ops-alerts"

Returns the endpoint id and a signing secret. Subsequent deliveries include:

X-SF-Signature: t=1714572345,v1=hex(hmac_sha256(secret, "{t}.{body}"))
X-SF-Endpoint-Id: we_...
X-SF-Delivery-Id: del_...

See Webhook receiver for verification code samples.

Delivery and dedupe

Alert delivery is idempotent per rule, channel, endpoint, and window. A rule should not re-fire the same condition more than once inside its dedupe window. Webhook receivers should also idempotency-key on X-SF-Delivery-Id.

Runtime architecture

The evaluator runs server-side. It uses live market data where available and falls back to REST snapshots when needed. Users configure watched objects, alert rules, channels, endpoints, and dedupe windows; they do not need to run a local process for server-side alerts.

Next steps

Watch + alert API

Endpoint shapes and curl examples.

Webhook events

Every event payload shape.

Webhook receiver

Verification + retry handling code samples.

Webhooks

Endpoint registration and signing.

Unit pilots

Workflows

Integrations

Watchlist + alerts

Add to watchlist

Create an alert rule

Register a webhook endpoint

Delivery and dedupe

Runtime architecture

Next steps

Watch + alert API

Webhook events

Webhook receiver

Webhooks

​Add to watchlist

​Create an alert rule

​Register a webhook endpoint

​Delivery and dedupe

​Runtime architecture

​Next steps

Watch + alert API

Webhook events

Webhook receiver

Webhooks

Add to watchlist

Create an alert rule

Register a webhook endpoint

Delivery and dedupe

Runtime architecture

Next steps