CAI Terminal — User Guide

Version: 1.0.1

Platform: Windows Desktop

Exchange: Bybit (Linear Perpetual Futures)

Website: caiterminalapp.com

Back to CAI Terminal main page

Table of Contents

1. Overview
2. System Requirements
3. Installation & First Launch
4. Login
5. Main Interface Overview
6. Settings
7. Creating Orders
8. Managing Active Positions
9. Managing Limit Orders
10. Risk Management System
11. Analytics (Trade History)
12. Statistics Panel
13. Sub-Accounts Selection
14. Auto-Refresh & Status Bar
15. Automatic Updates
16. Security
17. Configuration File Reference
18. Troubleshooting
19. Glossary

1. Overview

CAI Terminal is a desktop trading terminal for the Bybit cryptocurrency exchange. It allows you to:

• Manage multiple sub-accounts from a single interface
• Place market and limit orders on USDT-settled linear perpetual futures
• Set and manage Take Profit (main & partial) and Stop Loss levels
• Monitor active positions and pending limit orders in real time
• Enforce per-account risk management rules (daily loss limits, trade caps, losing-days cooldown)
• Auto-adjust position sizing based on remaining daily risk budget
• View weekly and monthly PnL statistics
• Analyze closed trade history with win-rate calculations
• Automatically refresh positions at configurable intervals
• Broadcast order actions across all selected sub-accounts simultaneously

2. System Requirements

3. Installation & First Launch

1. Download the latest release from the CAI Terminal website.
2. Extract the archive to any folder (e.g., C:\CAITerminal).
3. Ensure appsettings.json is present in the same directory as the executable.
4. Double-click CAITerminal.exe to launch.

On first launch you will be prompted to log in (see Login).

4. Login

When the application starts, a Login dialog appears:

• Press Enter to submit.
• Press Escape to cancel and exit the application.

5. Main Interface Overview

After login, the main window opens with the following layout:

Main Tabs

Menu Bar

6. Settings

Open settings via the menu bar → Settings.

6.1 General & Trading Settings

Click Save to persist. Settings are written to appsettings.json.

6.2 Sub-Accounts

Navigate to the Sub-Accounts tab in Settings. Each sub-account represents one Bybit API key pair.

Add a Sub-Account

1. Click Add.
2. Fill in the fields:

3. Click Save. API keys are encrypted with your PIN before being stored.

Edit / Delete a Sub-Account

• Select a row and click Edit or Delete.
• Deleting requires confirmation.

6.3 Risk Management (Per Sub-Account)

Each sub-account has its own risk management configuration inside the RiskManagement section. This is configured in appsettings.json directly or through the Sub-Account editor. See Risk Management System for full details.

7. Creating Orders

1. Click the Create New Order button on the right side.
2. Risk management checks run automatically for all sub-accounts before the order form opens. Accounts that fail are unchecked and a summary is shown.
3. The order creation panel appears.

7.1 Market Orders

• Check Market Order.
• The entry price auto-fills with the current market price.
• The order executes at (or near) the current market price.

7.2 Limit Orders

• Check Limit Order.
• Enter your desired Entry Price.
• If price hasn't been reached yet, a conditional (trigger) order is created:

• Long: if market < entry → triggers when price rises to entry.
• Short: if market > entry → triggers when price falls to entry.

7.3 Direction (Long / Short)

• Click Long (green) to go long / buy.
• Click Short (red) to go short / sell.
• The Place Order button updates: "Buy Market", "Sell Limit", etc.

7.4 Risk Percent

Select a Risk Percent from the dropdown. This scales the sub-account's Order Amount:

• 100% = full amount
• 50% = half
• etc.

Only percentages enabled in Settings appear.

7.5 Stop Loss & Take Profit on Order Creation

Optionally set Stop Loss and Take Profit directly on the order.

Validation:

• Long: SL must be below entry price.
• Short: SL must be above entry price.
• SL = 0 means no stop loss is set.

7.6 Order Sizing: Standard vs. SL-Based

There are two modes per sub-account, controlled by UseOrderAmountAsStopLossAmount.

Standard Mode (UseOrderAmountAsStopLossAmount = false)

The Order Amount is used directly as the notional value.

SL-Based (Risk) Mode (UseOrderAmountAsStopLossAmount = true)

This ensures that if Stop Loss is hit, the maximum loss equals the Risk Amount. Requires a Stop Loss to be set.

If Auto-Adjust Risk to Remaining Daily Limit is enabled, the Risk Amount is further capped at the remaining daily risk budget (see section 10.4).

Placing the Order

Click Place Order. The order broadcasts to all checked sub-accounts.

8. Managing Active Positions

8.1 Positions Grid

The Active Positions tab displays all open positions grouped by sub-account:

Right-click on any position row to open the context menu:

8.2 Set Main Take Profit

1. Right-click → Main Take Profit.
2. Enter the TP price.
3. Click Set Take Profit.

If Set Main TP On All Positions is enabled, the TP is applied to the same symbol/direction on all sub-accounts.

8.3 Set Main Stop Loss

1. Right-click → Main Stop Loss.
2. Enter the SL price.
3. Click Set Stop Loss.

Same broadcast logic as TP when "Set Main SL On All Positions" is enabled.

8.4 Add Partial Take Profit

Partial TPs close a portion of your position at a specified price.

1. Right-click → Add Take Profit.
2. The panel shows:

• Entry Price (read-only)
• Total Quantity — remaining quantity not assigned to partial TPs
• Quantity — amount to take profit on (adjustable via slider 0–100% or manual input)
• Take Profit Price
• Profit — estimated profit (auto-calculated)

3. Click Set Partial TP.

Validation:

• Long: TP must be above entry. Short: TP must be below entry.
• TP cannot be zero.

If Add Partial TP On All Positions is enabled, only the % slider and TP price are shown; quantity is calculated per sub-account individually.

8.5 Close Position

1. Right-click → Close Position, or click the Close button in the grid.
2. Adjust the quantity via slider (0–100%) or manual entry.
3. Estimated PnL is shown based on last price.
4. Click Close Position → confirm with Yes.

A market close order is placed for the specified quantity.

8.6 Expand Position Details

Click + on a position row to query all partial Take Profit orders:

Click − to collapse.

8.7 Sub-Account Balance Tooltip

Hover over a sub-account header row. After ~250ms, a tooltip shows:

• Available Balance (settle coin)
• Wallet Balance (settle coin)

Fetched live from Bybit.

9. Managing Limit Orders

9.1 Limit Orders Grid

9.2 Set TP / SL on Limit Orders

1. Right-click → Take Profit or Stop Loss.
2. Enter the price → click the button.

This modifies the existing order on Bybit.

9.3 Cancel a Limit Order

Click Cancel on the row, or right-click → Cancel Order.

If Cancel Limit Orders On Position Close is enabled and multiple limit orders exist for the same symbol, you'll be prompted to cancel all of them at once.

10. Risk Management System

CAI Terminal includes a comprehensive per-sub-account risk management system that runs automatically before every order creation. When you click "Create New Order", the system checks each sub-account and disables (unchecks) any that violate the rules.

10.1 Daily Loss Limit

Controls how much you can lose in a single trading day.

Example: If Type = "Amount" and Amount = 100, and your closed PnL today is −$105, the account is disabled.

10.2 Maximum Trades Per Day

Example: If you have 2 closed trades, 2 open positions, and 1 open limit order = 5 total. No more orders can be placed.

10.3 Losing Days Protection

Prevents trading after consecutive losing days.

10.4 Auto-Adjust Risk to Remaining Daily Limit

How it works:

1. The system calculates: Remaining Risk = Allowed Daily Loss − |Today's Realized Loss|
2. If Remaining Risk < Risk Amount, the Risk Amount is capped to Remaining Risk
3. If Remaining Risk ≤ 0, the order is blocked entirely

10.5 How Risk Checks Work

When you click Create New Order:

1. ✅ Daily Loss check — Has today's PnL exceeded the limit?
2. ✅ Max Losing Trades — Have you hit the max losing trades for today?
3. ✅ Max Trades Per Day — Have you reached the total trade cap (closed + open + limit)?
4. ✅ Losing Days Protection — Are you in a consecutive-loss cooldown period?

If any check fails for a sub-account:

• The account is unchecked in the Sub-Accounts list
• UseInNewOrder is set to false and saved
• A summary dialog shows all restrictions

11. Analytics (Trade History)

1. Switch to the Analytics tab.
2. Select a sub-account (only one at a time).
3. Set From and To dates.
4. Click Get Trades.

The grid shows closed trades grouped by Symbol + Entry Price:

Statistics update to show:

• Total PnL for the date range
• Win Rate — wins / (wins + losses)
• Weekly PnL — current week
• Monthly PnL — current month

12. Statistics Panel

Located on the right side, always visible:

Click any label to manually refresh.

13. Sub-Accounts Selection

On the right panel, the Sub-Accounts tab shows a checklist:

• Check = include when placing new orders or broadcasting TP/SL
• Uncheck = exclude
• Select All checkbox for bulk toggle

Header shows count: Sub-Accounts (3/5) = 3 of 5 selected.

Changes are saved to appsettings.json immediately.

14. Auto-Refresh & Status Bar

Auto-Refresh

Positions, limit orders, and statistics refresh automatically at the configured interval (default: 300 seconds).

Status Bar

• Next refresh in: XXs — countdown to next refresh
• Notification area — last action or error message
• Hover over notifications to see a scrollable history log (last 200 entries with timestamps)
• Error messages appear in red

15. Automatic Updates

On startup, the application checks for a newer version. If found:

• Title bar shows: CAI Terminal - v1.0.1 | New version available: X.X.X
• A dialog prompts to visit the download page
• Click Yes to open in browser

Manual check: menu → Check for Updates.

16. Security

• API Key Encryption: Keys are encrypted using AES-256-GCM with a key derived from your PIN (PBKDF2, 100,000 iterations). Stored as Base64 in appsettings.json.
• PIN: Held in memory only during the session. Never written to disk.
• Telegram ID: Used for server-side authentication. Stored in plaintext.

17. Configuration File Reference

All settings are in appsettings.json.

Full Settings Reference

18. Troubleshooting

19. Glossary

Back to CAI Terminal main page

© CAI Terminal — caiterminalapp.com