# Blitz Synce 3.0.0 — Blitz Synce Bridge (cài xong là dùng)

## Tiếng Việt

### Cài đặt nhanh: 3 bước

1. **Cài đặt:** chạy [Blitz] Activator Synce.exe, dán key SYNC-… và bấm KÍCH HOẠT. Tick các phần mềm muốn cài (ATAS / ATAS X, cTrader, MT5, Sierra Chart) rồi bấm CÀI ĐẶT.
   - Nếu máy chưa có .NET 10 Runtime, bộ cài hỏi và tự tải từ Microsoft (khoảng 30 MB, Windows hỏi quyền một lần).
   - Hub tự chạy nền (biểu tượng Blitz Synce ở khay đồng hồ) và tự chạy mỗi khi mở Windows.
2. **Nguồn (nơi bạn vào lệnh, ví dụ ATAS):** thêm indicator **Blitz Synce Bridge (Source / Receiver)** lên chart hợp đồng muốn copy (ví dụ NQZ6). Giữ nguyên cài đặt mặc định (Receiver tắt).
3. **Đích (cTrader / MT5):** chạy cBot/EA **BlitzSynceBridge** trên chart mã CFD tương ứng (NQ → US100 / NAS100…). Bật **Receiver** và **Enable execution**, chọn **Fixed lots** và **Maximum lots**.

Không cần điền số tài khoản, Endpoint ID hay routes.json. Hub tự ghép mỗi đích với nguồn đang chạy cùng nhóm mã. Nhấp đúp biểu tượng Blitz Synce để xem nền tảng nào đang kết nối và tuyến nào đang copy.

**Lưu ý:**
- Tài khoản–mã đích phải dành riêng cho copier: không vào lệnh tay trên cùng mã đó. Đích phải trống vị thế khi bắt đầu copy.
- Nếu nguồn đang có vị thế lúc bạn bật đích, vị thế đó được copy ngay. Tắt Enable execution ở đích khi chưa muốn copy.

### Kích hoạt license

- License lưu tại C:\BlitzSynce. Hub kiểm tra license lúc chạy và định kỳ 6 giờ; mất mạng vẫn chạy tối đa 12 giờ.
- License không hợp lệ: Hub chặn mở/thêm lệnh, vẫn xử lý giảm/đóng và bảo vệ vị thế.
- Đổi máy: bấm HỦY KÍCH HOẠT trên máy cũ rồi kích hoạt máy mới.

### ATAS / ATAS X

- ATAS thường: `%APPDATA%\ATAS\Indicators`. ATAS X: `%APPDATA%\ATAS X\Indicators`. Chọn đúng nền tảng ở danh sách cạnh đường dẫn.
- Nếu chưa thấy indicator: Indicators → Add custom indicator → chọn `BlitzSynce.ATAS.dll` tại đường dẫn bộ cài báo.
- Mặc định: Channel folder dùng chung, Endpoint ID = auto, Expected account để trống (tự lấy tài khoản của chart).
- DLL dành cho ATAS / ATAS X chạy .NET 10. Nếu import báo lỗi runtime, gửi thông báo lỗi và file `OFT.Platform.runtimeconfig.json` / `OFT.PlatformX.runtimeconfig.json` cho bên hỗ trợ.
- Đổi kỳ hạn (NQZ6 → NQH7): làm khi không có vị thế. Bridge tự đổi ID theo mã mới và Hub tự ghép lại.

### cTrader

- Mở `BlitzSynce.algo` đã cài để nhập vào cTrader, chọn cBot BlitzSynceBridge → chart mã CFD → Start. Cho phép Full Access.
- Mặc định: Endpoint ID = auto, Expected account number để trống.
- Đích: Receiver = Yes, Enable execution = Yes. Money Management: FixedLots (số lot cố định) hoặc RiskPercent (% Equity, nguồn phải có SL và TP). Maximum lots là trần.
- Spread compensation (SL/TP) = Yes (mặc định): SL/TP tính từ giá đóng lệnh (Buy: Bid, Sell: Ask) nên chạm cùng lúc với nguồn trên biểu đồ. Lỗ tại SL thêm 1 spread, lời tại TP bớt 1 spread. Đặt No để giữ đúng số tiền lời/lỗ như nguồn.
- Mỗi mã một instance. Không chạy 2 copier trên cùng tài khoản–mã. Dừng bản cũ trước khi Start bản mới.

### MT5

- Navigator → Expert Advisors → Refresh, kéo BlitzSynceBridge lên chart đúng mã.
- Mặc định: EndpointId = auto, ExpectedAccount = 0 (tự lấy login).
- Đích: Receiver = true, EnableExecution = true, bật Algo Trading của EA và của terminal. SpreadCompensation = true (mặc định) như cTrader.

### Sierra Chart

- DLL nằm trong thư mục Data của Sierra Chart x64. Analysis → Studies → Add Custom Study → Blitz Synce Bridge.
- Điền Channel folder là thư mục kênh bộ cài báo, cùng Endpoint ID, Expected account và Expected trade symbol. Hub tự ghép theo nhóm mã.
- Thử bằng Trade Simulation trước. Không copy tín hiệu replay.

### Nhóm mã được tự ghép

- NASDAQ100: NQ/MNQ ↔ NQ, US100, NAS100, USTEC.
- SP500: ES/MES ↔ US500, SP, SPX, SPX500, SPX 500, SP500.
- GOLDUSD: GC/MGC ↔ XAUUSD, XAU/USD, GOLD.
- SL/TP giữ đúng khoảng cách quanh giá khớp ở đích; có bù spread (xem mục cTrader).

### Trạng thái & xử lý lỗi

- Nhấp đúp biểu tượng Blitz Synce: danh sách nền tảng (● đang chạy / ○ dừng) và tuyến copy.
- WAITING_SOURCE: chưa có nguồn cùng nhóm mã đang chạy. AMBIGUOUS_SOURCE: có hơn một nguồn cùng nhóm mã, hãy tắt bớt.
- TARGET_EXECUTION_DISABLED: đích chưa bật Enable execution hoặc Algo Trading. CONFLICT: đích có vị thế/lệnh khác trên cùng mã.
- Đích tự chạm SL/TP trên broker: Hub chờ broker đóng lệnh (PROTECTION_TRIGGERED), không khóa tuyến.
- Nguồn xóa SL/TP: đích xóa theo sau 5 giây (ATAS tạm báo SL/TP = 0 khi kéo lệnh hoặc khi stop khớp). PROTECTION_RETRY: broker từ chối sửa SL/TP, Hub tự thử lại và vẫn copy lệnh đóng.
- Nếu một lệnh chưa rõ kết quả, Hub dừng tuyến đó (HALTED / UNCERTAIN). Mở nền tảng đích, kiểm tra mã nhận copy không còn vị thế và lệnh chờ, rồi chuột phải biểu tượng Blitz Synce → **Mở khóa tuyến bị dừng**. Vị thế nguồn đang mở lúc đó không bị copy; tuyến copy lại từ lệnh kế tiếp.
- Fixed lots phải ≥ khối lượng tối thiểu của mã đích (ví dụ US 100 thường là 0.1). Nhỏ hơn thì Hub bỏ qua lệnh (BELOW_TARGET_MIN).
- Menu chuột phải biểu tượng: Trạng thái copy, Mở thư mục kênh, Mở khóa tuyến bị dừng, Khởi động lại Hub, Tự chạy cùng Windows, Thoát.
- Nâng cấp: chạy bản mới và bấm CÀI ĐẶT. Hub cũ được dừng an toàn (không đóng vị thế) rồi chạy lại. routes.json viết tay được giữ nguyên.

## English

### Quick start: 3 steps

1. **Install:** run [Blitz] Activator Synce.exe, paste your SYNC-… key and press ACTIVATE. Tick the platforms (ATAS / ATAS X, cTrader, MT5, Sierra Chart) and press INSTALL.
   - If .NET 10 Runtime is missing, the installer offers to download it from Microsoft (about 30 MB, one Windows permission prompt).
   - The Hub then runs in the background (Blitz Synce tray icon) and starts with Windows.
2. **Source (where you trade, e.g. ATAS):** add **Blitz Synce Bridge (Source / Receiver)** to the contract chart (e.g. NQZ6). Keep the defaults (Receiver off).
3. **Receiver (cTrader / MT5):** run the **BlitzSynceBridge** cBot/EA on the matching CFD chart (NQ → US100 / NAS100…). Turn on **Receiver** and **Enable execution**, set **Fixed lots** and **Maximum lots**.

No account numbers, Endpoint IDs or routes.json to type: the Hub pairs each receiver with the live source of the same symbol group. Double-click the Blitz Synce tray icon to see connected platforms and active copy routes.

**Notes:**
- Dedicate the receiver account–symbol to the copier (no manual trades on it). It must be flat when copying starts.
- A source position that is open when you enable the receiver is copied immediately. Keep Enable execution off until you want copying.

### License

- Stored in C:\BlitzSynce. The Hub validates at start and every 6 hours; it keeps working offline for up to 12 hours.
- An invalid license blocks new/increased exposure; reductions, closes and protection continue.
- To move PCs, DEACTIVATE the old PC, then activate the new one.

### ATAS / ATAS X

- Classic ATAS: `%APPDATA%\ATAS\Indicators`. ATAS X: `%APPDATA%\ATAS X\Indicators`. Select the platform next to its folder.
- If the indicator is missing: Indicators → Add custom indicator → select `BlitzSynce.ATAS.dll` at the path shown by the installer.
- Defaults: shared Channel folder, Endpoint ID = auto, Expected account empty (uses the chart's account).
- The DLL targets ATAS / ATAS X builds running .NET 10. For runtime import errors, send the error and `OFT.Platform.runtimeconfig.json` / `OFT.PlatformX.runtimeconfig.json` to support.
- Roll contracts (NQZ6 → NQH7) while flat: the bridge derives a new ID and the Hub pairs it again.

### cTrader

- Open the installed `BlitzSynce.algo` to import it, choose the BlitzSynceBridge cBot → CFD chart → Start. Grant Full Access.
- Defaults: Endpoint ID = auto, Expected account number empty.
- Receiver: Receiver = Yes, Enable execution = Yes. Money Management: FixedLots or RiskPercent (% of Equity; the source needs SL and TP). Maximum lots is the cap.
- Spread compensation (SL/TP) = Yes (default): SL/TP are measured from the closing price (buy: Bid, sell: Ask), so they trigger after the same chart move as the source. The SL loses one more spread, the TP earns one less. Set No to keep the source cash result instead.
- One instance per symbol. Never run two copiers on the same account–symbol. Stop the old instance before starting a new one.

### MT5

- Navigator → Expert Advisors → Refresh, then attach BlitzSynceBridge to the correct symbol chart.
- Defaults: EndpointId = auto, ExpectedAccount = 0 (uses the login).
- Receiver: Receiver = true, EnableExecution = true; enable EA and terminal Algo Trading. SpreadCompensation = true (default), as in cTrader.

### Sierra Chart

- The DLL belongs in the Sierra Chart x64 Data folder. Analysis → Studies → Add Custom Study → Blitz Synce Bridge.
- Enter the channel folder shown by the installer, an Endpoint ID, Expected account and Expected trade symbol. The Hub pairs it by symbol group.
- Test in Trade Simulation first. Replay is not copied.

### Symbol groups paired automatically

- NASDAQ100: NQ/MNQ ↔ NQ, US100, NAS100, USTEC.
- SP500: ES/MES ↔ US500, SP, SPX, SPX500, SPX 500, SP500.
- GOLDUSD: GC/MGC ↔ XAUUSD, XAU/USD, GOLD.
- SL/TP distances are kept around the receiver's fill price, with spread compensation (see cTrader).

### Status & troubleshooting

- Double-click the Blitz Synce tray icon: platforms (● live / ○ stopped) and copy routes.
- WAITING_SOURCE: no live source of that symbol group. AMBIGUOUS_SOURCE: more than one source of that group; keep one.
- TARGET_EXECUTION_DISABLED: Enable execution or Algo Trading is off. CONFLICT: other positions/orders on the receiver symbol.
- Receiver SL/TP reached at its broker: the Hub waits for the broker close (PROTECTION_TRIGGERED) and keeps the route running.
- A removed source SL/TP is removed on the receiver after 5 s (ATAS briefly reports 0 while an order is dragged or a stop fills). PROTECTION_RETRY: the broker refused an SL/TP change; the Hub retries and still copies closes.
- If an order result is unclear, the Hub halts that route (HALTED / UNCERTAIN). Open the receiver platform, check that the copied symbol has no position and no pending order, then right-click the Blitz Synce icon → **Unlock halted routes**. A source position that is open at that moment is not copied; copying resumes with the next trade.
- Fixed lots must be at least the receiver symbol's minimum volume (US 100 is often 0.1). Smaller sizes are skipped (BELOW_TARGET_MIN).
- Tray right-click menu: Copy status, Open channel folder, Unlock halted routes, Restart Hub, Start with Windows, Exit.
- Upgrade: run the new version and press INSTALL. The old Hub is stopped safely (positions stay open) and restarted. A hand-written routes.json is kept.