# Winner's Circle Auto-Trade — NinjaTrader Setup

This guide walks you through wiring your NinjaTrader 8 account to Winner's Circle so signals are placed automatically with your own ATM template (Entry + TP + SL all atomic).

**Estimated time:** 5–10 minutes for first install. ~1 minute for each additional instrument.

---

## 1. Prerequisites

- **NinjaTrader 8** installed (simulator or live account).
- A funded NT broker account (simulated is fine to test).
- Connected to **live market data** for the symbol you want to trade.
- A Winner's Circle dashboard account (same email that receives signals).

---

## 2. Sign in to the dashboard

1. Open your dashboard.
2. Click the **⚡ Auto-Trade** tab.
3. If prompted, enter your email and click **Send Sign-in Link**.
4. Open the email from Winner's Circle and click the link — you're now signed in for 30 days.

The first time you land on Auto-Trade after signing in, a personal **Webhook URL** is generated automatically. Keep this secret — anyone with it can receive your trade signals.

---

## 3. Create your ATM template (inside NinjaTrader)

Your ATM template defines how each trade is managed once entered (stop-loss, take-profit, trailing, breakeven, etc.). You create it **once**; every signal placed by Winner's Circle uses it.

1. In NinjaTrader, go to **Tools → ATM Strategies**.
2. Click **New**.
3. Name it `WinnersCircle_Default` (or any name — you'll type the same name on the dashboard).
4. Configure a **Stop Loss** and **Target 1** in ticks that suit your risk.
5. Optional: enable **Trailing Stop** / **Auto Breakeven** as you prefer.
6. Click **Save** and close.

---

## 4. Install the Winner's Circle strategy

1. Download `WinnersCircleAutoTrader.cs` from the dashboard (link in the Auto-Trade tab) or from the workspace share.
2. In NinjaTrader open **New → NinjaScript Editor**.
3. In the left panel right-click **Strategies → Import File…**
4. Pick `WinnersCircleAutoTrader.cs` and click Open.
5. Press **F5** (Compile). You should see **0 errors**.

If compilation fails, copy the error text into the dashboard feedback form.

---

## 5. Configure the strategy on a chart

1. Open a chart for **any** instrument (it can even be a symbol you don't trade — the strategy uses the signal's symbol, not the chart's).
2. Right-click the chart → **Strategies…** → find **WinnersCircleAutoTrader** → **Add**.
3. Fill the parameters:
   - **Webhook URL** — paste from the dashboard Auto-Trade tab.
   - **ATM Template** — `WinnersCircle_Default` (or whatever you named it).
   - **Poll seconds** — `2` is recommended.
   - **Allow BUY / Allow SELL** — both `True` unless you're long-only or short-only.
   - **Require live mode** — `True` for live accounts, `False` when testing in sim.
4. Set **Enabled** to **True** and click **OK**.

The log panel should show: `[WinnersCircle] Auto-trader started. Polling every 2s.`

---

## 6. Turn Auto-Trade ON at the dashboard

Back on the dashboard Auto-Trade tab:

1. Pick your **Symbol** (e.g. `MNQ`). Signals for other symbols are ignored.
2. Set **Contracts per trade** (start with 1).
3. Adjust **Directions**, **Timeframes**, **Min grade**, **Min confidence**, **Daily cap**.
4. Enter the ATM name you created (e.g. `WinnersCircle_Default`).
5. Click **Save Auto-Trade Settings**.
6. Flip the **OFF → ON** toggle at the top of the tab.

That's it. Signals that match your filters will auto-place.

---

## 7. Verify

- **Dashboard:** Open the **Recent Auto-Trade Deliveries** card — it will show each signal queued to you, pending or delivered.
- **NinjaTrader log:** Strategy log will show `[WinnersCircle] ✅ ATM placed — BUY MNQ x1 (signal #…)`.
- **NinjaTrader Control Center:** You'll see the order + ATM bracket live.

---

## 8. Rotate the webhook URL

If your token is ever exposed (shared screen, leaked URL, etc.):

1. Dashboard → Auto-Trade → **Rotate (invalidate old URL)**.
2. Copy the new URL.
3. In NinjaTrader, open the strategy parameters and paste the new URL; click OK.

The old URL stops working immediately.

---

## 9. Common issues

| Symptom | Fix |
|---|---|
| `HTTP 404 from server — check your WebhookUrl` | Token was rotated on the dashboard; paste the new URL. |
| `ATM failed: Specified ATM strategy does not exist` | Your `AtmTemplate` name doesn't match a template in NT. Go to Tools → ATM Strategies and verify the exact name. |
| Strategy log silent after enable | Chart is in historical-only mode; connect live data or disable `Require live mode` for sim accounts. |
| Signals queued but nothing placed | Strategy is disabled on the chart, or Auto-Trade toggle is OFF on the dashboard. Check both. |
| Wrong instrument gets the order | The signal's **symbol** is what we send to NT. Make sure your dashboard **Symbol** matches the one you actually want (and is NOT set to a different root). |

---

## 10. Security notes

- Webhook URL contains a 48-char random token. Treat it like a password.
- No username/password to your broker is ever sent to Winner's Circle.
- Winner's Circle can only tell your NT *what* to trade — your NT places the order on your broker using your local credentials.
- You can stop auto-trading instantly by flipping the dashboard toggle OFF, or by disabling the strategy in NT.

---

## Support

If something breaks, open the dashboard Feedback modal (top-right button) and include:
- The exact error text from the NT log.
- Your dashboard Symbol and ATM template name.
- A short note on what you were doing when it broke.

We read every message.