TAX
Welcome to Phantom Traders
Phantom Traders is an institutional-grade portfolio intelligence platform for independent traders. This documentation covers everything from setup to advanced API usage.
New here? Start with the Quick Start guide — you'll have a live portfolio in under 5 minutes.
What Phantom Traders Does
At its core, Phantom Traders gives you:
- Real-time portfolio tracking — live prices, P&L, and performance across all holdings
- AI risk intelligence — dynamic risk score from 6 quantitative metrics
- Smart alerts — 6 alert types delivered via in-app, email, or SMS
- Stock screener — filter + AI recommendations based on your portfolio gaps
- Tax harvesting — automatic loss opportunity identification
- Trade journal — block calendar with stocks and options support
System Requirements
Phantom Traders runs entirely in your browser — no download, no install.
| Browser | Minimum Version | Recommended |
|---|---|---|
| Chrome | 90+ | Latest ✓ |
| Firefox | 88+ | Latest ✓ |
| Safari | 14+ | Latest ✓ |
| Edge | 90+ | Latest ✓ |
| Mobile (iOS/Android) | Modern browser | Chrome/Safari ✓ |
Quick Start Guide
Get your portfolio live in under 5 minutes. Follow these steps:
1
Create your account
Click Sign Up, enter your email and password. No credit card needed for the free plan.
2
Choose your trader type
The onboarding wizard asks 5 quick questions to personalise your risk settings and AI insights.
3
Add your first holdings
Enter each ticker, the number of shares, and your average cost basis. Prices fetch automatically.
4
Set your first alert
Click Alerts in the sidebar → New Alert → pick a ticker and a price target. Choose your notification channel.
5
Review your risk score
Your risk score and AI insight will compute automatically once your holdings are entered. Click the card to open the full analytics panel.
Tip: Use the portfolio size switcher (S·10 / M·25 / L·50) on the dashboard to see how different portfolio sizes affect your risk score and metrics.
Account Setup
Profile Settings
Access your profile by clicking your name in the bottom-left sidebar. From here you can update:
- Full name, email, phone number
- Timezone and currency display preference
- Plan badge and renewal date
- Notification preferences (4 toggles)
- Connected brokerage accounts
- Two-factor authentication
Notification Setup
Before alerts can reach you, configure your channels in Profile → Notifications:
| Channel | Setup required | Plan |
|---|---|---|
| In-app | None — automatic | All plans |
| Verify your email address | Pro+ | |
| SMS | Add + verify phone number | Pro+ |
Portfolio Tracking
Adding Holdings
Click + Add Holding in the dashboard header. Enter:
- Ticker symbol — e.g. AAPL, NVDA, BRK-B
- Shares — total number of shares held
- Average cost — your average cost per share (not total cost)
The market price, day change, and all calculations populate automatically once the holding is saved.
Price Refresh
Prices auto-refresh every 30 seconds. The status badge in the holdings header shows:
- ● Live — real-time feed active (Pro/Desk)
- ◎ Delayed — 15-minute delayed prices (Free)
- ◌ Loading — fetch in progress
Free tier note: Yahoo Finance prices are used on the free plan and are subject to a 15-minute delay. Upgrade to Pro for Polygon.io real-time data.
Calculated Columns
| Column | Formula |
|---|---|
| Mkt Value | Shares × Current Price |
| Gain / Loss $ | (Current Price − Avg Cost) × Shares |
| Total Return % | (Current Price − Avg Cost) / Avg Cost × 100 |
| Day Chg $ | (Current Price − Prev Close) × Shares |
| Weight | Position Market Value / Total Portfolio Value × 100 |
Risk Score
The risk score is a 0–100 number computed from 6 quantitative metrics derived from your actual holdings. It recalculates on every price tick and every portfolio change.
Score Calculation
| Metric | Direction | Max Impact |
|---|---|---|
| HHI Concentration | ↑ Increases risk | +40 pts |
| Weighted Portfolio Beta | ↑ Increases risk | +20 pts |
| Losing Position Weight | ↑ Increases risk | +15 pts |
| Sector Diversity | ↓ Reduces risk | −20 pts |
| Position Count | ↓ Reduces risk | −10 pts |
| Win Rate | ↓ Reduces risk | ±5 pts |
Risk Labels
| Score Range | Label | Meaning |
|---|---|---|
| 0 – 31 | ◉ Low Risk | Well-diversified, defensive, low beta |
| 32 – 47 | ◉ Mod-Low | Good balance, minor concentration |
| 48 – 64 | ⊛ Moderate | Average market risk, typical portfolio |
| 65 – 79 | ⊛ Mod-High | Elevated concentration or high-beta sectors |
| 80 – 100 | ⚠ High Risk | Heavy concentration, very high beta, losses |
Tip: Click the Risk Score card on your dashboard to jump directly to the Analytics panel for the full breakdown.
Price Alerts
Creating an Alert
Go to Alerts in the sidebar → click + New Alert. Fill in:
- Ticker — the stock symbol (e.g. AAPL)
- Alert type — choose from 6 types (see below)
- Target value — price $ or % depending on type (not required for Earnings/News)
- Notify via — In-app, Email, SMS, or All channels
- Note — optional personal label shown when the alert triggers
Alert Types
| Type | Triggers when | Value required |
|---|---|---|
| Price above $ | Price ≥ your target | Target price |
| Price below $ | Price ≤ your floor | Floor price |
| % increase | Price up X% from creation time | % amount |
| % decrease | Price down X% from creation time | % amount |
| Earnings reminder | 2 days before earnings date | None |
| News detected | Material news event for ticker | None |
Stock Screener
The screener lets you filter a curated list of stocks across 6 dimensions and view AI-powered recommendations based on your current portfolio gaps.
Available Filters
| Filter | Type | Notes |
|---|---|---|
| Sector | Dropdown | 8 sectors available |
| Min Price | Number | Filters out sub-penny stocks |
| Max Price | Number | Leave empty for no ceiling |
| Max P/E | Number | Leave empty to include all |
| Min Div Yield % | Number | 0 includes all stocks |
| Signal | Dropdown | Strong Buy, Hold, Sell, Value, Growth, Income |
| Search | Text | Searches ticker symbol and company name |
AI Recommendations
The green strip at the top of the screener shows 3 stocks the AI recommends for your specific portfolio. Recommendations are based on:
- Sectors underweight vs target allocation
- Dividend yield gap (if income is a goal)
- Beta imbalance (portfolio too high/low vs market)
- Positions with strong analyst consensus
Click ↻ Refresh to cycle through three different recommendation sets.
Tax Harvesting
Disclaimer: Tax calculations are estimates based on a 15% long-term capital gains rate. Always consult a qualified tax advisor before transacting.
How It Works
Go to Tax Harvesting in the sidebar. The panel shows:
- Unrealized Gains — total paper gains across all winning positions
- Unrealized Losses — total paper losses across all losing positions
- Est. Tax Liability — Gains × 15% (long-term rate)
- Harvest Opportunities — each losing position as an actionable card
Harvesting a Position
Each harvest card shows:
- Ticker and current loss amount
- Estimated tax savings if harvested (Loss × 15%)
- A
Harvestbutton that queues a sell order
After harvesting, you can replace the position with a similar (but not substantially identical) ETF or stock to maintain market exposure while locking in the tax loss.
Trade Journal
Logging a Trade
Go to Journal in the sidebar. Click any day on the calendar to open the trade editor. For stock trades:
- Select Shares mode (default)
- Enter ticker, direction (Long/Short), entry price, exit price, and share count
- P&L preview shows immediately: (Exit − Entry) × Shares
For options trades, click Options mode:
- Select Call or Put
- Enter strike price, expiry date, premium in, premium out, and contract count
- P&L: (Premium Out − Premium In) × Contracts × 100
Monthly Statistics
The stats bar at the bottom of the journal auto-calculates for the visible month: total P&L, win rate %, win/loss count, trading days, total trades, and best day.
Plan Comparison
| Feature | Free | Pro $20/mo | Elite $50/mo |
|---|---|---|---|
| Holdings | 10 | Unlimited | Unlimited |
| Price data | 15-min delay | Real-time | Real-time |
| Monthly price | $0 / free | $20/mo | $50/mo |
| Annual price | — | $199/yr ($17/mo · save 30%) | $499/yr ($42/mo · save 17%) |
| AI risk score | ✗ | ✓ | ✓ |
| Tax harvesting | ✗ | ✓ | ✓ |
| Stock screener + AI | ✗ | ✓ | ✓ |
| Trade journal | ✗ | ✓ | ✓ |
| Email alerts | ✗ | ✓ | ✓ |
| SMS alerts | ✗ | ✗ | ✓ |
| API access | ✗ | ✗ | ✓ |
| Discord Community | ✗ | ✗ | ✓ Included free |
| Brokerage sync (Plaid) | ✗ | ✗ | ✓ Coming soon |
| Team members | 1 | 1 | 2 |
How to Upgrade
Click Billing in the sidebar → select your plan → click Upgrade. You'll be taken to Stripe's secure checkout. Upgrades take effect immediately.
Annual discount: Choose annual billing to save 30% — Pro drops from $20 to $14/month, Desk from $50 to $50/month.
Cancellation
Cancel any time from Billing in the sidebar → click Cancel Subscription. You retain Pro access until the end of your current billing period. Your data is preserved — downgrade to Free, not deletion.
API Authentication
The Phantom Traders API uses Bearer token authentication. Tokens are available on the Elite plan under Settings → API Keys.
Request header
Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxx
Base URL
https://api.phantomtraders.com/v1
Rate Limits
| Plan | Requests/min | Requests/day |
|---|---|---|
| Elite | 60 | 10,000 |
| Pro | — | API not available |
Portfolio Endpoints
GET /portfolio
Returns all holdings with live prices, P&L, and weights.
POST /portfolio/holdings
{
"symbol": "AAPL",
"shares": 50,
"avg_cost": 178.20
}
DELETE /portfolio/holdings/:symbol
Removes a holding from the portfolio.
Alerts Endpoints
GET /alerts
Returns all alerts with status (active/triggered).
POST /alerts
{
"symbol": "NVDA",
"type": "price-above",
"value": 150.00,
"notify": ["email", "sms"],
"note": "Breakout level"
}
DELETE /alerts/:id
Deletes an alert by ID.