🚀 Welcome to Signal Marksman AI
Signal Marksman AI is a desktop algorithmic trading dashboard. It connects to your exchange, streams live market data, and fires AI-powered signals based on EMA crossovers and StochRSI analysis.
⚡ Quick Start (3 steps)
- Get your credentials from your administrator — accounts are created by Signal Marksman admin.
- Sign in with the email + password you were given. You'll be asked to set your own password the first time.
- Pick your exchange & connect API keys — Binance, Bybit, CoinDCX, Upstox, Dhan, Angel One, or OctaFX.
💡 One account, all platforms. Register once — sign in and switch platforms freely each session. Your settings and trade history are saved per device.
🎮 Demo vs Real mode
The app starts in Demo mode — all signals, chart, and paper trades work with a simulated $1,000 balance. No exchange connection needed.
Switch to Real mode from the top toolbar once you've connected an exchange API key to see your live balance and place actual orders.
📡 Supported Platforms
- Binance — Global crypto spot + futures. Fully supported (orders, live data).
- Bybit — Global crypto spot + linear perpetuals. Fully supported.
- CoinDCX — Indian crypto exchange. Live data + balance. Orders coming soon.
- Upstox — Indian stock broker. Live data. Balance via daily OAuth.
- Dhan — Indian stock broker (NSE/BSE, F&O). Live data, balance, positions, orders. Access token lasts ~30 days.
- Angel One — Indian stock broker (SmartAPI). Live data, balance, positions, orders. Auto-login via TOTP.
- OctaFX — Forex & CFDs via MT5 (global edition only).
👤 How to Create an Account
- Click the "Create account" tab on the login page.
- Select your trading platform from the grid (you can change this later at each login).
- Fill in your Full name, Email, and a Password (minimum 6 characters).
- Click "Create account" — you'll be logged in automatically.
✅ Your account is stored locally on this device in an encrypted database. No data is sent to any cloud server.
🔑 Forgot Password?
- Click "Forgot password?" on the Sign In tab.
- Enter your registered email and a new password.
- Click "Reset password" — you can sign in with the new password immediately.
🔄 Switching Platforms
At each login, select a different platform button before signing in. The dashboard will load data and chart information for that platform. Your account and trade history are shared across all platforms.
🔗 Connecting Your Exchange
After logging in, click "+ Exchange" in the top-right toolbar of the dashboard. This opens the Exchange Settings modal where you can enter your API key and secret.
- Select your exchange tab (Binance, Bybit, etc.).
- Paste your API Key and API Secret (or Access Token for Upstox).
- Click "Connect & validate" — the app tests your key against the exchange live.
- Once connected, switch to Real mode to see your live balance.
⚠️ Read-Only keys only. Never enable Withdrawal or Transfer permissions on keys you enter here. The app only reads balance and places trades — it never needs withdrawal access.
🔒 Key Security
All API keys are encrypted with AES-128 (Fernet) and stored in a local SQLite database at ~/.signal_marksman_ai/ctp_data.db. The encryption key is at ~/.signal_marksman_ai/vault.key — never share this file.
❓ Which permissions to enable?
- Read Only — for viewing balance and chart data only (Demo mode)
- Spot Trading — to place real buy/sell orders on spot markets
- Futures Trading — to place orders on futures/perpetual contracts
- ❌ Withdraw — NEVER enable this
- ❌ Transfer — NEVER enable this
🔑 How to Get API Keys
Each exchange has its own API management page. Follow the steps below for your platform:
Binance
1. Log in at
binance.com
2. Click your profile icon →
Account → API Management
3. Click
"Create API" → choose
"System generated"
4. Label it (e.g. "CTP") → complete 2FA verification
5. Set permissions:
Enable Reading +
Enable Spot & Margin Trading
6. Copy the
API Key and
Secret Key (secret shown only once — save it!)
Bybit
1. Log in at
bybit.com
2. Click profile →
API →
Create New Key
3. Choose
"System-generated API Keys"
4. Select
Read-Write, enable
Trade permission
5. Optionally restrict to your IP for extra security
6. Copy the
API Key and
API Secret
CoinDCX
1. Log in at
coindcx.com
2. Click profile avatar →
Profile → API Keys
3. Click
"Generate API Key"
4. Complete 2FA / OTP verification
5. Copy the
API Key and
Secret Key (secret shown only once)
D
Dhan
1. Log in at
dhan.co → My Profile
2. Open
DhanHQ Trading APIs & Access
3. Make sure the top-right toggle is on
"Access Token" (not API Key) mode
4. Click
"+ Generate new Access Token"
5. Enter an Application Name, set
Token validity to 24 Hours (the maximum Dhan allows), leave Postback URL blank →
Generate Access
6.
API Key = your Dhan
Client ID (numeric, visible in your profile)
7.
API Secret = the Access Token string you just generated
⚠️ Dhan tokens expire after 24 hours — you'll need to regenerate + re-paste your Access Token every morning before trading.
A
Angel One
1. Sign up at
smartapi.angelbroking.com
2. Create a
Trading API and copy the
API Key
3. As
API Secret, paste a JSON blob:
{"clientCode":"...","password":"MPIN","totpSecret":"BASE32_FROM_QR"}
4. TOTP secret is the base32 string Angel shows when enabling 2FA (we generate the 6-digit code automatically)
Upstox
1. Log in at
developer.upstox.com
2. Go to
My Apps → Add New App
3. Set
Redirect URI to exactly:
http://127.0.0.1:7432/oauth/callback/upstox
4. Copy the
API Key (Client ID) and
API Secret
5. After connecting, you'll see a
"Login for today" banner each day — this is normal. Upstox access tokens expire daily and must be refreshed via OAuth each morning.
💡 Having trouble? Make sure the app is running (server online) before clicking Connect & Validate — the server tests the key against the exchange live.
