Accounts

Accounts represent your brokerage trading accounts. UTM connects to your broker to sync positions, orders, and execute trades.

Account Types

UTM distinguishes between two account types:

Type	Description	Risk
Paper	Simulated trading, no real money	None
Live	Real trading with real money	Real financial risk

Trading Mode Safety

UTM enforces strict mode separation. You cannot place live orders while in paper mode, and vice versa. This prevents accidental real-money trades.

Connecting an Account

Step 1: Add Broker Connection

1. Navigate to Settings > Brokers
2. Click Add Broker
3. Select your broker (e.g., TradeStation)
4. Complete OAuth authentication
5. Broker connection is established

Step 2: Import Accounts

After broker connection:

1. UTM automatically discovers your accounts
2. Review the list of available accounts
3. Select which accounts to import
4. Accounts appear in your account list

Step 3: Configure Account

For each account, you can set:

Setting	Description
Nickname	Friendly name for the account
Account Type	Paper or Live (usually auto-detected)
Default	Make this the default for new orders
Active	Enable/disable trading on this account

Account Information

Balance Data

UTM syncs the following from your broker:

Field	Description
Equity	Total account value
Cash	Available cash balance
Buying Power	Available for new positions
Day Trading BP	Day trading buying power (if applicable)
Market Value	Value of all positions

Positions

Each account shows current holdings:

• Symbol and quantity
• Average cost basis
• Current market value
• Unrealised P&L

Order History

View orders placed through this account:

• Pending orders
• Filled orders
• Cancelled/rejected orders

Trading Mode

Switching Modes

Click the mode indicator in the header:

• PAPER (green badge) - Demo trading mode
• LIVE (red badge) - Real trading mode

UTM will ask for confirmation before switching to LIVE mode.

Mode Enforcement

When you place an order or process a signal:

1. UTM checks your current mode (Paper/Live)
2. UTM checks the target account type
3. If they don't match, the order is blocked

This prevents scenarios like:

• Accidentally placing real orders while testing
• Processing paper signals to live accounts

Syncing Data

Automatic Sync

UTM syncs account data:

• On login
• After placing orders (7-second delay)
• Periodically in the background

Manual Sync

Click the sync icon next to an account to force refresh:

• Balance updates
• Position updates
• Order status updates

Sync Status

Status	Meaning
✓ Green	Recently synced, data is fresh
⚠ Yellow	Data may be stale
✗ Red	Sync error occurred

Account Permissions

Tradeable vs View-Only

Some accounts may be view-only:

Permission	Can View	Can Trade
Tradeable	Yes	Yes
View-Only	Yes	No

View-only accounts show balances and positions but cannot place orders.

Margin vs Cash

Account Type	Description
Cash	Can only use settled cash
Margin	Can borrow for larger positions

UTM displays buying power based on account type.

Multiple Accounts

Account Selection

When placing orders or signals, always select the target account:

1. Account dropdown shows all active accounts
2. Only tradeable accounts appear for order entry
3. Account type (Paper/Live) shown for each

Cross-Account Views

The Dashboard aggregates across accounts:

• Total equity (all accounts combined)
• Combined positions
• All recent orders

Filter by account for individual views.

Troubleshooting

Account Not Syncing

1. Check broker connection status
2. Try manual sync
3. Re-authenticate broker if needed
4. Check broker API status

Balance Mismatch

Balances may differ from broker due to:

• Pending orders affecting buying power
• Sync timing (try manual refresh)
• Unsettled trades

Cannot Place Orders

Check:

• Account is marked as "Tradeable"
• Account is active (not disabled)
• Trading mode matches account type
• Account has sufficient buying power

Broker Disconnected

If broker connection fails:

1. Go to Settings > Brokers
2. Find the disconnected broker
3. Click Reconnect
4. Complete re-authentication

This may happen when:

• OAuth tokens expire
• Broker requires re-authorization
• Network issues occurred