Getting Started
Download & Install
Download BPS Tracker from the App Store. Requires iOS 17 or later. Open the app after installation to get started.
Tip: On first launch, Demo mode displays sample data to help you explore the app features.
Alpaca Account Connection (Optional)
Connect your Alpaca account to get real-time market prices and Greeks data. This is an optional feature - the app works without it.
Go to Settings page
Tap "Login with Alpaca" button
Complete OAuth authorization on Alpaca website
You'll be redirected back to the app automatically
Note: Alpaca market data has a 15-minute delay, not real-time quotes.
Main Screen Overview
The main screen has several sections:
- Portfolio Summary
Shows Capital at Risk, Max Profit, Unrealized P&L, Theta/Day
- Position Cards
Each position card displays underlying, strikes, expiry, and P&L
- Filter Tabs
Switch between All / Open / Closed positions
Add Position
Field Descriptions
Tap the "+" button in the top right to add a new position. Fill in the following:
Symbol
Stock ticker symbol (e.g., AAPL, SPY, QQQ). The system validates the symbol.
Short Strike
The strike price of the Put you SELL in the Bull Put Spread. This is the higher price.
Long Strike
The strike price of the Put you BUY for protection. This is the lower price.
Credit
Net premium received per share (e.g., $1.50 means $150 per contract).
Contracts
Number of contracts traded. 1 contract = 100 shares.
Open Date / Expiry Date
Used to calculate DTE (Days to Expiry) and holding days.
Real-time Preview
As you enter data, a preview shows:
Max Loss
(Width - Credit) × 100 × Contracts
Max Profit
Credit × 100 × Contracts
Breakeven
Short Strike - Credit
Potential RoR
Max Profit ÷ Max Loss
Example: AAPL Bull Put Spread
Symbol
AAPL
Contracts
5
Short Strike
$175
Long Strike
$170
Credit
$1.50
Width
$5.00
Max Profit
$750
Max Loss
$1,750
Position Tracking
Greeks Explained
Greeks measure options risk. BPS Tracker shows Net Greeks for Bull Put Spreads (Net = Long - Short):
Delta
Price sensitivity - how much the option value changes per $1 move in underlying.
Ideal range: -0.10 to +0.10 (near neutral)
Gamma
Rate of Delta change per $1 move in underlying.
Ideal range: -0.01 to 0 (low curvature risk)
Theta
Daily time decay value. Main profit source for sellers.
Ideal range: Positive (earning time value daily)
💰 Daily Theta Value = Net Theta × 100 × Contracts
Vega
Sensitivity to 1% change in implied volatility (IV).
Ideal range: -0.05 to 0 (controlled IV risk)
P&L Display
Unrealized P&L
(Credit Received - Current Close Cost) × 100 × Contracts
The percentage in parentheses shows how much of Max Profit has been earned. E.g., "$150 (75%)" means 75% of max profit achieved.
Color Meaning
Risk Warning Labels
DTE ≤ 7 days, approaching expiration
Current price below Short Strike, assignment risk
Using real Alpaca option quotes
Close Position
How to Close
Tap a position card to open details
Tap "Close Position" button
Enter close date and close price (Debit paid)
(Optional) Select a close reason
Review P&L preview and tap "Close Position"
Close Reasons (Optional)
Recording close reasons helps review trading decisions. Default options:
Trading Related
Time Related
Market Related
P&L Calculations After Close
Realized P&L
(Credit - Close Price) × 100 × Contracts
Return on Risk (RoR)
Realized P&L ÷ Max Loss × 100%
Annualized RoR
RoR × (365 ÷ Holding Days)
Performance Analysis
History Page
Tap "History" in the navigation to view complete trade history and performance stats.
Statistics
- Total TradesTotal number of closed trades
- Win RateProfitable trades ÷ Total trades
- Total P&LSum of all realized P&L
- Avg RoRAverage Return on Risk
- Avg Holding DaysAverage days held
CSV Export / Import
Export CSV
Export position data to CSV from History or main screen. Uses standard OCC option symbol format for use with other tools.
Import CSV
Import CSV files from Settings to batch add positions. Import is additive - existing data is preserved.
CSV format example:
ShortPutSymbol,LongPutSymbol,OpenDate,Contracts,Credit,Status AAPL250117P00175000,AAPL250117P00170000,2024-12-01,5,1.50,open
Settings
Alpaca Account Management
Connect Account
Tap "Login with Alpaca" for OAuth authorization to get real-time market data.
Disconnect
When connected, tap "Disconnect" to unlink your Alpaca account. App continues to work but without real-time prices and Greeks.
Demo Mode
Enable Demo Mode to display sample positions for exploring app features. Disable to enter your own real trades.
Note: Demo Mode data does not affect your real position data.
Delete Account
"Delete Account" clears all local data including:
- All position records
- Trade history
- Alpaca authorization token
- All settings
Warning: This action cannot be undone. Please confirm before proceeding.
Questions? Contact us:support@ai-muninn.com