1 Pick a broker
Two tabs at the top: 01 Firstock and 02 AliceBlue. Each broker has its own session — you can be signed in to both at once, log out of one without affecting the other.
2 Single user — download your own P&L
- Stay on the Single user sub-tab (default).
- Enter your broker User ID, password, and TOTP (either the 6-digit code or your base32 secret key).
- Click Sign in. The download card appears.
- Pick a date range and segment.
- Preview shows the raw broker response. Download Excel ships a multi-sheet workbook (Summary · Charges · Trade Details). Download JSON gives the raw payload.
3 Multi-user batch — download for many clients
- Switch to the Multi-user batch sub-tab.
- Click Download template — opens an XLSX with column headers + 3 example rows.
- Fill in your clients below the examples. Required:
user_id, password, totp_access_key (the base32 secret, not the 6-digit code). Optional: name, per-row dates, notes.
- Save the file. Drag-drop or click to upload it.
- Set generic from/to dates + segment (used as fallback when a row's dates are blank).
- Click Run batch & download ZIP.
- The ZIP contains one workbook per client plus a master summary file (
Summary_Report.xlsx for Firstock, batch_summary.xlsx for AliceBlue) listing every client's P&L, charges, and brokerage in one sheet.
4 Where to find your TOTP secret
The TOTP secret is the long base32 string (~32 chars like JBSWY3DPEHPK3PXP…), not the rotating 6-digit code.
- In your broker's app, start the "Enable 2FA" or "Reset TOTP" flow.
- On the QR-code screen, look for a "can't scan?" or "show key" link — that reveals the secret.
- Copy that secret and paste it into the
totp_access_key column (batch) or TOTP field (single-user).
- Scan the QR into your authenticator app too, so normal login still works.
Single-user login also accepts a current 6-digit code if you'd rather type that. Batch requires the base32 secret because the server mints a fresh code per client.
5 Segments
- Firstock:
CM (Cash Market / Equity) · FO (Futures & Options).
- AliceBlue:
CM · FO · both. The "both" option fetches Equity + F&O and ships one workbook per segment per client (so each client ends up with two .xlsx files in the ZIP).
6 Live log
Each broker panel has its own expandable Live Log at the bottom. It streams every step in real time — login attempts, retries, file builds, errors. When a batch finishes, a per-client summary table appears under the log showing P&L · Charges · Brokerage with a total row.
7 Lock the dashboard
Top-right Lock button drops you back to the login screen. Broker logins persist server-side in memory until you log out of each broker separately or the process restarts.
Tips
- Nothing is written to the server's disk — credentials, uploaded client lists, and generated files all live in memory only.
- Ranges > 1 year are auto-chunked into 364-day windows for AliceBlue (Firstock has no chunking limit).
- Rows in the batch template whose
user_id starts with EXAMPLE_ are silently skipped — you can leave the samples in.
- Press Esc to close this help.