158 lines
4.2 KiB
Markdown
158 lines
4.2 KiB
Markdown
# GizerBridge – Sierra Chart → Tralgo Analytics
|
||
|
||
**Automatically transfers completed trades from Sierra Chart to Tralgo Analytics — on Linux.**
|
||
|
||
Sierra Chart runs on Linux via Wine/Bottles/Lutris. Tralgo Analytics has no official importer for this setup. GizerBridge fills that gap.
|
||
|
||
> Built and used daily in live ES/NQ futures trading.
|
||
|
||
---
|
||
|
||
## How it works
|
||
|
||
GizerBridge connects directly to Sierra Chart via the **DTC Protocol** (TCP on `localhost:11099`).
|
||
No log file polling. No manual export. Trades are detected and transferred in real time as they close.
|
||
|
||
```
|
||
Sierra Chart (DTC Server)
|
||
│
|
||
│ TCP · localhost:11099
|
||
▼
|
||
GizerBridge
|
||
│
|
||
│ HTTPS · Tralgo Analytics API
|
||
▼
|
||
Tralgo Analytics
|
||
```
|
||
|
||
- Already-sent trade IDs are stored locally → no duplicate uploads
|
||
- Manual import available for historical trades
|
||
- Runs as a system tray app (AppImage, no installation required)
|
||
|
||
---
|
||
|
||
## Requirements
|
||
|
||
- Linux (any distribution)
|
||
- Sierra Chart running via Wine / Bottles / Lutris
|
||
- DTC Protocol Server enabled in Sierra Chart
|
||
- Active Tralgo Analytics account
|
||
- Firefox (for session authentication)
|
||
|
||
### Enable DTC in Sierra Chart
|
||
|
||
`Global Settings → Data/Trade Service Settings → DTC Protocol Server`
|
||
→ Enable, Port: `11099`
|
||
|
||
---
|
||
|
||
## Installation
|
||
|
||
**Option A – AppImage (recommended, no install needed)**
|
||
|
||
1. Download the latest `GizerBridge.AppImage` from [Releases](../../releases)
|
||
2. Make it executable:
|
||
```bash
|
||
chmod +x GizerBridge.AppImage
|
||
```
|
||
3. Run it:
|
||
```bash
|
||
./GizerBridge.AppImage
|
||
```
|
||
|
||
**Option B – From source**
|
||
|
||
```bash
|
||
git clone https://github.com/gizerlabs/gizerbridge.git
|
||
cd gizerbridge
|
||
bash install.sh
|
||
```
|
||
|
||
---
|
||
|
||
## First Start – Setup
|
||
|
||
On first launch, the settings window opens automatically:
|
||
|
||
| Field | What to enter |
|
||
|---|---|
|
||
| **API Key** | Your `transfer_token` from Tralgo Analytics |
|
||
| **Tralgo E-Mail** | Your login e-mail (display only) |
|
||
| **SC DTC Host** | `localhost` (default) |
|
||
| **SC DTC Port** | `11099` (default) |
|
||
| **Accounts** | Account names exactly as shown in Sierra Chart |
|
||
| **Instruments** | Enable instruments, verify tick sizes and values |
|
||
|
||
Save → the app connects immediately and starts monitoring.
|
||
|
||
---
|
||
|
||
## Tralgo Login (once every 30 days)
|
||
|
||
The app reads the session cookie from Firefox — your password is never stored or transmitted.
|
||
|
||
1. Open Firefox and go to `tralgo.app`
|
||
2. Log in with your e-mail and password
|
||
3. Enter the 2FA code from your e-mail
|
||
4. **Enable "Remember for 30 days"** ← required
|
||
|
||
---
|
||
|
||
## System Tray
|
||
|
||
After start, a colored status dot appears on the tray icon:
|
||
|
||
| Color | Status |
|
||
|---|---|
|
||
| 🟢 Green | Running, monitoring for new trades |
|
||
| 🟡 Yellow | Initializing |
|
||
| 🔴 Red | Error (session expired, connection issue) |
|
||
|
||
Right-click the tray icon → Open · Manual Import · Settings · Log · Quit
|
||
|
||
**No tray icon on GNOME?**
|
||
Install the [AppIndicator Extension](https://extensions.gnome.org/extension/615/appindicator-support/) and restart the app.
|
||
|
||
---
|
||
|
||
## Security
|
||
|
||
- No password is stored or transmitted
|
||
- Firefox cookie database is read as a temporary copy — never modified
|
||
- Config file (`~/.gizerbridge_config.json`) is stored with permissions `600`
|
||
- API key is stored locally, never logged or shared
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
| Problem | Solution |
|
||
|---|---|
|
||
| "Cookie missing" popup | Log in to tralgo.app in Firefox, enable "Remember for 30 days" |
|
||
| Red icon / transfer error | Check internet connection; open Status window for details |
|
||
| No trades detected | Verify account names in settings match Sierra Chart exactly |
|
||
| DTC connection failed | Confirm DTC Protocol Server is enabled in Sierra Chart on port 11099 |
|
||
|
||
Last 50 events: Right-click tray icon → **Log**
|
||
|
||
---
|
||
|
||
## Built with
|
||
|
||
- Python 3.11
|
||
- [DTC Protocol](https://www.sierrachart.com/index.php?page=doc/DTCProtocol.html) (Sierra Chart)
|
||
- [Tralgo Analytics API](https://tralgo.app)
|
||
- `requests`, `Pillow`, `pystray`
|
||
|
||
---
|
||
|
||
## Status
|
||
|
||
Active development. Used daily in live trading on ES/NQ futures.
|
||
Feedback and issues welcome → open a [GitHub Issue](../../issues).
|
||
|
||
---
|
||
|
||
*Not affiliated with Sierra Chart or Tralgo Analytics.*
|
||
*A [GizerLabs](https://gizerlabs.com) project.*
|