Pilots

In CandlePilot, Pilots are the bots that define your trading logic. You can build your own pilot from scratch or use pilots created by other users when they are available in the Pilot Store.

A pilot is more than a simple signal. It is a structured decision system made of Threads, Blocks, Rules, and Values that control when to open, close, protect, and adjust positions.

What a Pilot Represents

Each pilot combines strategy design and execution constraints, including:

• Identity and ownership (author and visibility status)
• Market scope with allowed symbols and intervals
• Execution event threads for open, close, stop loss, take profit, and trailing behavior
• Nested decision blocks with logical operators (AND/OR)
• Evaluation rules with comparisons like <, >, =, and !=
• Reusable values, either primitive values or function-based values
• Current strategy result references used for performance tracking

Pilot Structure Deep Dive

At strategy level, pilots are organized in layers:

1. ThreadsThreads represent event flows such as Open Long, Open Short, Close Long, Close Short, Stop Loss, Take Profit, and Trailing Stop.
2. BlocksEach thread starts with a root block, and blocks can contain nested blocks for more complex logic trees.
3. RulesRules are evaluation nodes inside blocks. They define condition checks and comparison behavior.
4. ValuesValues are rule inputs and thread-linked parameters. They can be primitive values (number, string, boolean, date) or dynamic function values with configs.

This structure allows you to model from simple conditions to advanced multi-step decision trees.

How Pilots Work in Practice

1. Create or choose a pilotStart by creating your own pilot or selecting one from the Pilot Store.
2. Define strategy constraintsSet allowed symbols and intervals to limit where the pilot can operate.
3. Build thread logicAdd event threads and compose logic using blocks, rules, and values.
4. Configure protection behaviorDefine stop loss, take profit, and trailing logic as part of the pilot structure.
5. Publish or keep privateKeep your pilot private, keep it as draft, or publish it so it can appear in the Pilot Store.

Pilot Store and Sharing

The Pilot Store is where public pilots are listed for discovery. This lets users learn from existing strategy designs and adopt reusable logic patterns.

A pilot can be in different visibility statuses:

• Draft: still being prepared
• Private: visible for personal use
• Public: available in the Pilot Store

Users can create their own pilots and also leverage shared ecosystem pilots available through store visibility.

Why Pilots Matter

Pilots are the strategy brain of CandlePilot. They separate decision logic from execution containers, so you can reuse, refine, and evolve strategies without rebuilding your entire operation.

This gives you:

• Reusable strategy components
• Clear visual logic structure
• Controlled publication and sharing
• Faster iteration from idea to execution

Pilots in One Sentence

A Pilot in CandlePilot is a structured bot strategy that combines threads, blocks, rules, and values to automate trading decisions, and it can be privately managed or shared through the Pilot Store.