Overview
A workflow is a saved research playbook: a graph of nodes that pull data, transform it, branch on conditions, and emit an artefact at the end. You build them once and rerun them on demand or on a schedule.
- Composable. 16 node types span data, transforms, logic, and outputs.
- Two ways to build. Drag nodes in the visual builder, OR ask Augur to compose one from natural language.
- Code-visible by design. Research is separated into ordered operations; every executed tool-backed node exposes the call it ran alongside its result instead of hiding the investigation in one generated program.
- Open-ended. Custom data nodes, transform and branch nodes, plus PineNode overrides let a workflow express bespoke analysis beyond the preset catalogue.
- Strategy-first. Every workflow must terminate in
output.emit_strategy— the artefact contract is a runnable PineNode strategy per pick. - Shareable. Each run gets a permalink; runs can also be exposed via a public shared slug.
/workflows. Open the visual builder at /workflows/builder, or edit an existing workflow at /workflows/builder/{id}. Run output lives at /workflows/run/{id}.Quickstart
The shortest path to a working workflow:
- Open
/workflows/builder. - Drag a
data.screenernode from the palette. - Drag a
output.emit_strategynode. - Draw an edge from the screener to the emit node.
- Click Save, then Run.
The run page opens with one card per node, streaming status in real time. The emit-strategy card surfaces the generated PineNode source ready to backtest.
generate_workflow_definition and renders a save-button card. Seethe Augur docs.Preset automations
Sentimentor ships eight complete research automations in the workflow library. These are implemented multi-step pipelines, not example prompts: each has a fixed tool allowlist, parameters, ranking instructions, output contract and server-side broadcast cadence. Open a preset to inspect or run it. The email-notifications page uses a Subscribe action to receive the centrally executed scheduled result and an Unsubscribe action to stop delivery.
| Preset | Broadcast cadence | Picks | Pipeline |
|---|---|---|---|
| Morning Movers Scan | Weekdays · 8:30 AM ET | 5 | Trend, sentiment, options flow, institutional levels and a PineNode strategy per pick |
| Oversold Bounce Hunt | Weekdays · 8:30 AM ET | 5 | Oversold screen, sentiment stabilization, institutional support and insider confirmation |
| Options Flow Plays | Weekdays · 8:30 AM ET | 5 | Options activity, historical put/call context, price confirmation and aligned PineNode strategies |
| Options Activity Breakout Scanner | Weekdays · 8:30 AM ET | 10 | Contract-activity ranking with explicit snapshot limitations and market-priced defined-risk plays |
| Bullish Dark Pool + Positive Sentimentor Prediction | Weekdays · 8:30 AM ET | 5 | Institutional accumulation, AI forecast, sentiment, analyst and options validation |
| Options Activity Breakout Scanner — Defined-Risk Setups | Weekdays · 8:30 AM ET | 10 | Available-factor scoring, price confirmation and deterministic vertical-spread construction |
| Earnings Run-Up Plays | Weekdays · 4:30 PM ET | 5 | Upcoming earnings, sentiment, flow, institutional activity and pre-print strategy output |
| Dividend Aristocrat Screen | Mondays · 8:30 AM ET | 5 | Valuation, dividend durability, analyst quality, timing and trend strategy output |
The three trial-enabled presets are Morning Movers, Oversold Bounce and Options Flow. A paid subscription unlocks the other five presets and custom workflows. Subscriptions are opt-in and can be disabled at any time.
Workflow anatomy
A workflow is a directed acyclic graph: nodes + edges + a single terminal output.
Nodes
Each node has a type (one of the 16 catalogued types), a category (data / transform / logic / output), a config object specific to its type, and zero or more output handles consumed by downstream nodes.
Edges
An edge connects an upstream node's output handle to a downstream node's input handle. The graph must be acyclic — the builder rejects edge proposals that would close a loop.
Node config
Each node type declares typed config fields. Selecting a node in the builder opens the side panel where you can edit them:string, number, select,multi-select, and textarea inputs are supported. Defaults are pre-populated.
Required terminal
Every workflow must terminate inoutput.emit_strategy. This is a hard constraint — the executor refuses to run a graph without it, and the builder shows a validation error if it's missing. The rationale: strategies are how workflows' findings get actioned (backtest, deploy, monitor), so the contract is strict.
output.email,output.webhook) can be added alongsideemit_strategy as additional sinks, but they can't replace it.Node catalogue
The catalogue mirrors Augur's tool surface: every data source the agent can call is also available as a workflow node. Add transforms / logic / outputs on top to assemble the playbook.
Data sources (14)
Each pulls live data from one of Augur's tools and emits a per-candidate table.
data.top_movers— gainers / losers / most-active.data.screener— quant filter on the equity universe.data.snapshot— live OHLC + volume per candidate.data.sentiment— Sentimentor sentiment composite.data.options_flow— sweeps, premium, call/put skew.data.dark_pool— off-exchange institutional prints.data.insider_sentiment— net insider buy/sell pressure.data.financial_metrics— P/E, EPS, margins, dividends.data.analyst_recommendations— consensus + target prices.data.earnings_calendar— upcoming earnings dates.data.economic_calendar— CPI / FOMC / NFP / GDP releases.data.cftc_commitments— commercial vs speculator positioning.data.news— recent headlines + AI sentiment per row.data.sentimentor_prediction— proprietary directional read.
Transforms (3)
transform.filter— drop candidates that don't match a condition.transform.rank— sort candidates by a composite score.transform.score— compute a numeric score per candidate.
Visual builder
The builder is a flow-graph editor with three panes: a left-side palette of node types, thecanvas in the middle, and a right-sideconfig panel for whichever node is selected.
Node palette
Nodes are grouped by category (data / transform / logic / output) and colour-coded: blue for data, purple for transforms, amber for logic, green for outputs. Drag-and-drop onto the canvas to add.
Side panel config
Click any node to populate the right panel with its config fields. Edits commit live to the in-memory graph — the workflow doesn't persist until you clickSave.
Drawing edges
Hover a node's output handle to grab a connector, then drag onto another node's input handle. Invalid edges (cycle introduction, type mismatch) are rejected with a hover tooltip explaining why.
PineNode overrides
Any node can carry a config.customCode override — an inline PineNode script the executor runsverbatim instead of the node's built-in tool call. This lets you drop hand-tuned logic (custom indicators, bespoke ranking, third-party API stitching) into an otherwise catalogue-driven workflow without forking the node type.
Open the side panel for any node and pick a saved strategy or click Override to write a fresh script in the inline code editor. Reset to preset restores the catalogue default. Placeholders in the form {{param}} in the override get substituted at run time from the node's config — everything else runs unchanged.
data.custom / output.emit_strategy. When present, translateGraphToSystemPrompt()emits a "Run the following PineNode script VERBATIM" STEPS line instead of the built-in{NodeLabel} tool call — so the executor treats the graph as your script rather than the catalogue default.Validation
Before save and before run, the builder checks:
- Exactly one
output.emit_strategyterminal exists. - No orphan nodes (every node must connect to the terminal somehow).
- No cycles.
- All required config fields are populated.
Failures surface inline as red badges on offending nodes; the run button stays disabled until everything is clean.
Building from Augur
The fastest way to build a non-trivial workflow is to describe the playbook to Augur. The agent callsgenerate_workflow_definition with a graph it composed from your description and renders a save-button card in the chat.
promptBuild a daily workflow: 1. Screen for momentum names (RSI 50–75, volume > 5M). 2. Pull sentiment + dark-pool levels for each. 3. Score and rank by composite (sentiment 50% / dark-pool delta 50%). 4. Emit a PineNode strategy for the top 3.
Review the proposed graph on the card, hit save, and the workflow lands in /workflows ready to run. Open it in the builder if you want to fine-tune nodes before the first run.
Unlock & edit
Chat-generated workflows open in the builder in a read-only preview. Click Unlock & edit to enter full edit mode: every node's side panel exposes its full config, and the PineNode override editor becomes available on all steps (not just the emit-strategy terminal). Save to persist your edits as a new revision of the workflow — the original chat proposal stays as the prior revision so you can revert.
Running a workflow
Manual run
From /workflows or from a workflow detail page, click Run. The run page opens immediately and starts streaming node-level status as the executor walks the graph.
Scheduled run
Any paid tier (Pro, Elite, Trader) can schedule workflows. Cron-style expressions are supported (0 9 * * 1-5 = 9:00 AM Mon–Fri). Scheduled runs trigger the same executor as manual runs and produce the same run-page output.
Run page
The run page renders one card per node. Cards show node label, status pill, and a tabbed body with the data the node produced.
Per-node tabs
Each node card may surface up to four tabs:
- Description — what the node did, in plain English.
- Table — the per-candidate output as a sortable table.
- Chart — bar / line / timeseries / scatter / equity / gauge rendering, when applicable.
- Code — the exact JavaScript-formatted operation and inputs used for that node; the emit-strategy node shows the generated PineNode source itself.
Which tabs appear depends on the node type. Data nodes with a chartKind declared (e.g.data.top_movers → bar) get the chart tab; everything else falls back to description + code.
AutoChart shape
Chart tabs pick their shape from the data itself rather than a fixed per-node chart type. The router inspects the emitted table and chooses:
- Radar for multi-dimensional signal tables (bullish / bearish / neutral score columns per entity) — overlays up to four top entities on up to six dimensions.
- Scatter for two numeric axes without a natural category dimension (e.g. price vs. volume).
- Bar as the fallback when the shape is a single-metric ranking (top movers, sentiment leaderboard).
AutoChart blacklists metadata columns from the auto-picked metric list — updated, timestamp,id, uuid, order,rank, round_lot, and anything whose values look like epoch-second timestamps (min ≥ 1e9 with a tight spread). This prevents charts of "last update time" showing up in place of the real metric.
Tool attribution
Each node card shows which tool calls produced it. When the backend supplies node_outputs, the attribution is exact; when it doesn't, the run page falls back to each node type's declared tools list.
Strategy artefact
The terminal output.emit_strategy card displays the generated PineNode strategy source with an Open in editor button. Multiple picks produce multiple strategy artefacts in one run; each can be opened independently. The terminal therefore does more than summarize the preceding analysis: it composes the surviving node-level evidence into executable, editable strategy logic that can be backtested and shared through /verify.
Workflow community
Sentimentor's /community gallery distributes complete AI research workflows—not screenshots or isolated prompts. Creators publish from the workflow library or visual builder; the listing records its author, description, category, tags, graph preview, research tools, views and number of times it has been added.
- Discover. Browse published workflows by category, recency or popularity.
- Inspect. Open a listing to review its synthesized graph, data-tool sequence, output size and creator before importing.
- Add a private fork. Add to my workflows duplicates the complete workflow into your account with private visibility and preserved source provenance.
- Customize. Change parameters, graph nodes and PineNode overrides without changing the creator's original.
- Run or schedule. Execute the fork on your own inputs or give it its own cadence.
- Share the variation. After materially changing the graph, publish the new version back to the community.
Scheduling
Any paid tier (Pro, Elite, Trader) can run workflows on a cron schedule. Configure the schedule from the workflow detail page:
cron# Every weekday at 9:35 AM ET 35 9 * * 1-5 # Hourly during market hours 0 9-16 * * 1-5 # Sunday night setup 0 22 * * 0
Each scheduled fire creates a normal run with its own permalink. The scheduler runs on AWS EventBridge; expect ±60s jitter on fire time.
Plan matrix
What's included where:
- Free. Access Market and the read-only Workflows page. Browse templates and Community previews, but do not run or import workflows.
- Trial. Seven days with up to 3 workflow runs. Community imports are not included.
- Pro. 10 workflow runs/month (on-demand + scheduled). Custom scheduling included.
- Elite. 25 workflow runs/month (on-demand + scheduled). Email + webhook outputs.
- Trader. 75 workflow runs/month (on-demand + scheduled). Cross-workflow data passing. Priority queue on busy hours.
Troubleshooting
- Run stuck on "pending". The executor is queued; on a busy hour this can take 30–60s before status flips to running.
- Node failed with a tool error. Open the code tab on the failing node card; the upstream response usually carries the rejection reason (rate limit, plan gate, transient 5xx).
- Run completed but the strategy card is empty. The screener produced zero candidates. Loosen the screener thresholds or check the Description tab for the count.
- Scheduled runs aren't firing. Confirm the schedule cron expression is correct AND that you haven't already spent your monthly workflow quota. If the quota is exhausted, the detail page shows the skip reason and fires resume on the 1st of the next month.
- Saved Augur-generated workflow won't run. Validation may have failed silently on save; open in the builder and look for red badges on offending nodes.
FAQ
Can I have branching paths that re-merge?
Branching is fine — multiple downstream paths from one upstream node are valid, and they can re-converge into a later transform. What's not allowed is a true cycle (a node depending on its own downstream output).