Skip to main content

Quick Start: Build Your First Strategy

This walkthrough takes you from a blank workspace to a working strategy. You will build a minimal two-state strategy that alternates on each new candle.

Prerequisites​

Step 1: Open SMITH​

  1. Click New Strategy in the sidebar.
  2. Enter a strategy name such as BTCUSD_Starter.

SMITH opens with an empty canvas and the save-readiness checklist.

Step 2: Subscribe to a data stream​

  1. Open the Strategy Toolbar.
  2. In Data, select Manage Data Sources.
  3. Subscribe to one candle stream.

That gives the strategy an event source to react to.

Step 3: Add two states​

  1. In the Strategy Toolbar, select Manage States.
  2. Click New State and create Watching.
  3. Create a second state named Active.

The checklist now satisfies At Least Two States Configured.

Step 4: Mark the initial state​

On the Watching node, turn on Initial State.

You can also do this from Manage States if you prefer the list view.

The checklist now satisfies Initial State Configured.

Step 5: Add transitions​

  1. On the Watching node, click Add Transition.
  2. Set the target state to Active.
  3. Use an event trigger that listens for the candle event from your subscribed stream.
  4. Save the transition.
  5. Add a second transition from Active back to Watching using the same pattern.

You could also create these from Manage Transitions -> New Transition.

The checklist now satisfies All States Have Transitions.

Step 6: Save the strategy​

Once the checklist is satisfied, save the strategy from the editor header.

SMITH closes and the new strategy appears on the HEARTH dashboard.

Step 7: Enable the strategy​

  1. Find the strategy tile on HEARTH.
  2. Turn the power toggle on.

The strategy is now live and will process events from its subscribed stream.

What next​