Build Workflows

Not sure where to start with automation? Start here. These examples are phrased the way real users actually ask, and every one maps to a workflow product surface that exists today.

Start with First-Time Setup if this is your first funded session.

💡 Local workflows support workflow_test before deployment. For message-based workflows, the test fires a real [TEST] -prefixed message via the configured platform so you can verify the channel works. If the target platform isn't connected yet, the test refuses up-front and tells you which provider to connect.

How to think about automation

Minara exposes two workflow backends:

• Local — the built-in workflow engine for scheduled briefs, alerts, notifications, and monitoring. Local workflows call tool handlers directly and do not spend tokens unless a workflow explicitly contains an LLM node.
• Cloud — Minara-hosted financial automation for capital-moving pipelines such as DCA, copy trade, wallet monitoring, and other market-connected workflows.

Autonomous trading strategies live in Autopilot, not in this section.

🟢 Local agentic workflows

These are the safest automation entrypoint. They watch, summarize, and notify. No funds move.

1. Telegram price alert

Prompt

Alert me on Telegram if ETH trades below $3000.

Agent response:

Creating a local price-threshold workflow:

• Backend: local
• Asset: ETH
• Trigger: last price below $3,000
• Delivery: Telegram
• Cooldown: 15 minutes between pushes

Confirm to create? Reply yes or no.

If you have not configured a channel yet, Minara stops and points you to Messaging.

2. Morning market brief

Prompt

Send me a BTC, ETH, and SOL market brief every day at 8am Shanghai time.

Agent response:

I'll create a scheduled local workflow:

• Schedule: every day at 08:00 Asia/Shanghai
• Assets: BTC, ETH, SOL
• Output: overnight move, key levels, trend, risk flags
• Delivery: chat + configured messaging channel

Confirm to create? Reply yes or no.

3. Custom monitoring workflow

Prompt

Create a workflow that emails me if BTC moves 5% in a day or if NVDA gaps more than 4% at the open.

Agent response:

Building a local monitoring workflow:

• Trigger A: BTC 24h move >= 5%
• Trigger B: NVDA open gap >= 4%
• Channel: email
• Run mode: monitoring only, no trade execution

Confirm to create? Reply yes or no.

4. High-frequency watchlist scan

Prompt

Watch the top 20 tokens by 24h volume and alert me every 15 minutes if any move more than 5%.

Agent response:

Preparing a local monitoring workflow:

• Schedule: every 15 minutes
• Universe: top 20 tokens by 24h volume
• Trigger: absolute move > 5%
• Delivery: chat + your configured notification channel
• Allowed tools: read, memory, messaging

Confirm to create? Reply yes or no.

Testing a local workflow before deployment

For local workflows, Minara can run a test execution before production:

1. workflow_test creates a manual test execution and runs the DAG end-to-end with sample inputs or an auto-generated trigger payload.
2. Messaging steps send for real, prefixed with [TEST] so you actually see the alert hit Telegram / Slack / email — the test verifies the channel works, not just the payload shape.
3. Fund-moving and other destructive tools are still simulated. The preview structure records what would have happened; nothing real gets dispatched.
4. If the workflow targets a platform you haven't connected yet, the test refuses up-front and tells you which provider is missing. Connect it via /connect <platform> (REPL) or Settings → Messaging (web UI), then re-run.
5. Production schedules and definition.active stay untouched — testing is safe to re-run as many times as you like.

That lets you verify, end-to-end, what the recipient will actually see before the workflow goes live.

Fire-once alerts

Most "ping me when X happens" alerts should fire once and then stop on their own — you don't want a fresh Telegram message every 15 minutes for the next month after GOOGL crosses $340. Pair send_message with a deactivate step:

{
  "entry": "fetch_quote",
  "trigger": { "type": "interval", "interval_ms": 900000 },
  "steps": {
    "fetch_quote": {
      "kind": "tool_call",
      "tool": "yahoo_finance_stock",
      "args": { "kind": "quote", "symbol": "GOOGL" },
      "next": "check"
    },
    "check": {
      "kind": "condition",
      "condition": "fetch_quote.price <= 340",
      "next": { "on_success": "alert", "on_failure": null }
    },
    "alert": {
      "kind": "send_message",
      "provider": "telegram",
      "text": "GOOGL hit $340",
      "next": "stop"
    },
    "stop": { "kind": "deactivate" }
  }
}

When the price condition first turns true, send_message delivers the alert and deactivate flips the workflow's own active = false. The next interval tick is skipped because the trigger manager respects the inactive flag, so the alert fires exactly once.

To re-arm: re-activate manually via the web UI's Schedule on button, the REPL /workflows activate <id> command, or just ask the agent in chat ("re-arm the GOOGL alert").

Turning on schedules that move money

If your workflow swaps tokens, buys, sells, or moves funds in any way and you turn on its schedule, Minara will not stop to ask "are you sure?" each time it runs. That's the whole point of a schedule. It runs by itself.

Heads up: clicking Schedule on for a money-moving workflow is a one-time yes for every future run. Before flipping the schedule on, the web UI shows you exactly which steps move money, how often the workflow will run, and asks you to check "I understand" before continuing. Cancel takes you back to one-off Run now, where each run still asks you to confirm trades.

Want to know how the safety check works under the hood? See Fund-moving confirmation.

🟡 Cloud automation workflows

These use Minara-hosted workflow infrastructure. They are for market- connected finance automation and may eventually move funds after manual activation.

5. Weekly DCA

Prompt

Set up a weekly DCA of $100 into BTC every Monday at 10am.

Agent response:

I'll prepare a cloud workflow draft:

• Backend: cloud
• Action: buy $100 USDC -> BTC
• Schedule: every Monday 10:00 local time
• Chain: Ethereum by default
• Daily spend cap: $100

Review the draft first. Activation is a separate manual step.

6. Copy-trade a smart wallet

Prompt

Copy trade this wallet 0xabc...def with a max buy size of $25 and a daily cap of $100.

Agent response:

Preparing a cloud copy-trade workflow:

• Backend: cloud
• Target wallet: 0xabc...def
• Max buy size: $25
• Daily cap: $100
• Filter: ignore trades below your minimum size
• Notifications: every mirrored trade will be pushed to you

Review the draft first. Activation is a separate manual step.

7. Wallet or market monitor with execution hooks

Prompt

Create a wallet monitor that follows this address and notifies me when it buys ETH or SOL.

Agent response:

I'll draft a cloud workflow:

• Backend: cloud
• Monitor target: wallet activity
• Symbols: ETH, SOL
• Notification routing: Telegram if available, otherwise email
• Activation: manual only

Review the draft before turning it on.

What belongs here vs elsewhere

• Use Workflows for alerts, scheduled summaries, monitoring, and cloud finance pipelines.
• Use Autopilot for automatic quantitative trading strategies with caps, kill conditions, and ongoing strategy review.
• Use Your First Trade for interactive one-shot trading with preview + confirm.

Where to go next

• Want to understand how local workflows run? -> Features → Workflows
• Want to configure notifications? -> Messaging
• Want autonomous strategy execution? -> Autopilot