> ## Documentation Index
> Fetch the complete documentation index at: https://help.tradespacepro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TradeSync: Monitor and Correct Follower Position Drift

> TradeSync continuously monitors leader and follower positions and automatically flattens followers that are out of sync with the leader caused by partial fills, rejections, or connectivity issues.

TradeSync is a safety layer for the Trade Copier that continuously monitors leader and follower positions, automatically flattening / cancelling any follower that drifts out of sync with the leader. Even when your copy group is running smoothly, real-world trading conditions can quietly introduce position mismatches — TradeSync catches them before they compound.

## Why You Need TradeSync

Under normal conditions the Trade Copier keeps followers in lockstep with the leader. But several real-world scenarios can cause a follower's position to diverge over time:

* **Partial fills**: The leader gets fully filled, but the follower only receives a partial fill — leaving the follower holding fewer contracts than expected.
* **Broker rejections**: An order sent to the follower is rejected by the broker (for example, due to margin or connectivity), resulting in no position when one should exist.
* **Connectivity interruptions**: A brief disconnect between Tradespace and a follower's broker means one or more copy signals are never received or acknowledged. This rarely happens but is possible.

Without TradeSync, these mismatches can happen without you beign aware. A follower that is one contract light after ten trades may be significantly out of sync with the leader by end of session — with no automatic mechanism to recover.

## How TradeSync Works

Tradespace constantly compares the leader's open positions with each follower's open positions. If the comparison reveals a mismatch that exceeds your configured tolerance, TradeSync steps in takes action to flatten that follower and prevent further trading on it until the leader's position and orders are completely flattened.

Corrective action means flattening the follower when the leader is flat or when the follower has any position or trade that does not match the leader. All TradeSync settings are per-follower.

## Manually Configuring TradeSync (coming soon).

We are working on releasing the ability for users to manually adjust TradeSync to fit their needs and adjust various settings to control how it works to best suit your needs.

<Steps>
  <Step title="Open your copy group">
    Go to **Trade Copier** in the left sidebar and click the copy group you want to configure.
  </Step>

  <Step title="Expand the TradeSync section">
    Locate the follower account you want to configure and expand its **TradeSync** section.
  </Step>

  <Step title="Enable TradeSync">
    Flip the **TradeSync** toggle to enabled. Tradespace will now begin monitoring this follower's positions against the leader.
  </Step>

  <Step title="Set Auto-Flatten behavior">
    Choose whether Tradespace should automatically flatten the follower's position if the leader goes flat but the follower still holds an open position.
  </Step>

  <Step title="Set Auto-Rearm behavior">
    Choose whether TradeSync should automatically re-enable itself after performing a correction action, so monitoring resumes without manual intervention.
  </Step>
</Steps>

## TradeSync Options

<ParamField body="Auto-Flatten" type="boolean">
  When enabled, Tradespace automatically flattens the follower's open position if the leader's position goes flat. This ensures the follower doesn't remain exposed to the market after the leader has fully exited. See the warning below before enabling this on live accounts.
</ParamField>

<ParamField body="Auto-Rearm" type="boolean">
  When enabled, TradeSync automatically re-enables itself after performing a correction action. Without Auto-Rearm, TradeSync disables after each correction and requires manual re-enabling before it will monitor again.
</ParamField>

<ParamField body="Drift Alerts" type="boolean">
  When enabled, Tradespace sends an alert notification whenever a position drift is detected between the leader and this follower. Use this to stay informed about mismatches even if you prefer to handle corrections yourself rather than using Auto-Flatten.
</ParamField>

<Note>
  TradeSync settings above are not available yet but are coming soon.
</Note>

<Warning>
  **Auto-Flatten closes follower positions at market price.** If a mismatch triggers Auto-Flatten during a fast-moving market, the fill price may be significantly different from the leader's exit price. Make sure you understand and accept this behavior before enabling Auto-Flatten on live accounts.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.