TaipTrade User Manual

Last updated: 2026-06-03 | Version: Flask SaaS App Complete reference for all TaipTrade features, usage, and how-to guides.

Getting Started

Creating an Account

Navigate to the TaipTrade app URL
Click Create Account (or go to /register)
Enter your email, display name, and password (minimum 8 characters)
Click Create Account — you will be logged in automatically

The first user to register gets admin privileges and a Pro subscription tier.

Logging In

Go to /login
Enter your email and password
Click Sign In

You stay logged in across sessions ("remember me" is enabled by default). To sign out, click Sign Out in the sidebar.

The sidebar on the left provides access to all features:

Icon	Page	Description
Dashboard	`/`	Performance overview and recent trades
Trade Journal	`/journal`	Full trade history with filtering and sorting
Market Brief	`/briefer`	AI-generated market briefings
GEX Dashboard	`/gex`	Gamma exposure levels, regime, and charts
Import Trades	`/import`	Upload broker CSV files to import trades
Wiki	`/wiki`	This documentation page
Settings	`/settings`	Account and preferences

Dashboard

Route: / (requires login)

The dashboard provides a quick overview of your trading performance.

Performance Cards

Eight metric cards across the top:

Metric	Description
Total Trades	Number of completed (entry + exit) trade pairs
Net P&L	Total profit/loss after fees across all trades
Win Rate	Percentage of trades with positive P&L
Profit Factor	Gross profit ÷ gross loss (>1.0 is profitable)
Avg Winner	Average P&L on winning trades
Avg Loser	Average P&L on losing trades
Best Trade	Highest single-trade P&L
Worst Trade	Lowest single-trade P&L

Daily P&L Chart

A bar chart showing your daily net P&L for the last 30 days. Green bars = profitable days, red bars = losing days.

Recent Trades

The 10 most recent trades (by exit date) are listed below the chart. Click any trade to see its full detail page.

Trade Journal

Route: /journal (requires login)

The trade journal shows every imported trade with powerful filtering and sorting.

Filtering

Use the filter bar at the top to narrow down trades:

Filter	What it does
Symbol	Search by ticker symbol (partial match, case-insensitive)
Broker	Filter by broker source (Fidelity, TOS, Tastytrade)
Trade Type	Filter by Day Trade, Swing Trade, or Position Trade

Sorting

Click any column header to sort. Click again to reverse the sort direction. Sortable columns:

Symbol, P&L (net), Exit Date, Entry Date, Quantity, Total Fees, P&L (gross), Trade Type, Broker

Pagination

Trades are shown 25 per page. Use the pagination controls at the bottom to navigate between pages.

Trade Detail

Click any trade row to see its full detail page (/journal/<trade_id>) which shows:

Entry and exit dates, prices, and quantities
P&L breakdown (gross, fees, net)
Holding duration (hours and days)
Trade classification (Day Trade / Swing Trade / Position Trade)
Time of day classification (Pre-Market / Opening / Morning / Midday / Afternoon / After-Hours)
Broker and account info
Tags and notes (editable in future versions)

Analytics

The journal page includes two analytics sections:

Trades by Symbol — breakdown of trade count and P&L per ticker
Trades by Time — performance grouped by time of day

Import Trades

Route: /import (requires login)

TaipTrade supports importing trade history from three brokers:

Supported Brokers

Broker	Export Type	How to Export
Fidelity	Account History CSV	Fidelity.com → Activity & Orders → History → Export
TOS / Schwab	Account Statement CSV	thinkorswim → Monitor → Account Statement → Select dates → Export
Tastytrade	Transaction History CSV	Tastytrade → History → Export CSV

Fidelity Import (2-Step Flow)

Step 1: Upload & Account Preview

Go to /import and click Choose File
Select your Fidelity CSV file
Click Upload & Preview
You will see a preview of all accounts found in the CSV with stats:
Account name (e.g., "Individual-TOD", "Roth IRA")
Number of trades per account
Trading accounts are auto-detected and pre-selected (recommended)
Non-trading accounts (HSA, 401k) are dimmed and unchecked by default

Step 2: Financial Breakdown & Import

Select which accounts to import (or keep the recommended defaults)
Click Preview Selected Accounts
Review the financial breakdown:
Realized P&L — profit/loss from closed trades (FIFO matched)
Unrealized P&L — estimated value of open positions (live market prices via yfinance)
Deposits & Withdrawals — cash movements
Dividends & Interest — income items
Pre-existing positions — holdings with no matching buy (e.g., transferred shares)
Click Confirm Import to save all trades to your journal

TOS / Schwab Import

Upload your TOS Account Statement CSV
Trades are parsed automatically (options, stocks, spreads)
Format detection warns you if you accidentally upload the wrong type (Trade Activity or Scanner CSVs are rejected with guidance)

Tastytrade Import

Upload your Tastytrade Transaction History CSV
Supports stock trades, short selling (SELL_TO_OPEN / BUY_TO_CLOSE), and expired options
Activity format detection rejects unsupported export types

Deduplication

TaipTrade automatically detects and skips duplicate trades when re-importing. Trades are matched on a composite key of: account, symbol, action, date, quantity, and price. This means you can safely import overlapping CSV files without creating duplicate entries.

The import summary shows how many trades were new vs. skipped as duplicates.

Import History

The bottom of the import page shows your recent import batches with: - Source filename - Broker detected - Number of raw rows and paired trades - Import status and timestamp

GEX Dashboard (Gamma Exposure)

Route: /gex (requires login)

The GEX Dashboard shows real-time gamma exposure levels for major indices and ETFs. This helps traders understand dealer positioning and make informed decisions about entries, exits, and risk management.

What is GEX?

Gamma Exposure (GEX) measures how much options market makers (dealers) need to hedge when the underlying price moves. It reveals hidden support and resistance levels that don't appear on traditional charts.

Positive Gamma: Dealers are long gamma — they buy dips and sell rallies, which dampens volatility. Expect range-bound, mean-reverting price action.
Negative Gamma: Dealers are short gamma — they sell dips and buy rallies, which amplifies volatility. Expect trending, momentum-driven moves.

Dashboard Layout

The GEX dashboard consists of five sections from top to bottom:

1. Symbol Selector & Provider Badge

At the top of the page:

Symbol input: Type any ticker symbol and click Analyze
Quick buttons: One-click access to SPY, QQQ, and IWM
Provider badge: Shows which data source is active (e.g., "THETADATA" or "YFINANCE") with a pulsing green dot indicating live data

A color-coded banner showing the current gamma regime:

Regime	Color	Meaning	Trading Implication
POSITIVE GAMMA	Green	Dealers stabilize price	Scalp, fade moves to walls, sell premium
NEGATIVE GAMMA	Red	Dealers amplify moves	Trade momentum/trends, hedge longs
NEUTRAL	Gray	Insufficient data	Wait for more data

The banner includes a Stability Gauge on the right side — a progress bar showing how far the current price is from the gamma flip level:

High stability (>60%): Price is far from the flip — current regime is likely to persist
Medium stability (30-60%): Approaching the flip — watch for regime changes
Low stability (<30%): Very close to the flip — regime change imminent

3. Trading Signal Pills

Inline colored badges showing actionable trading signals based on the current regime:

Positive Gamma signals (green pills): - SCALP / FADE to walls — Trade mean-reversion between support/resistance - SELL PREMIUM — Options premiums are rich due to range-bound action - WATCH $XXX flip — Monitor the gamma flip level for regime changes

Negative Gamma signals (red pills): - MOMENTUM / TREND — Trade in the direction of the trend - HEDGE LONGS — Protect long positions from amplified downside - WATCH $XXX flip — Monitor the gamma flip level

4. Key Levels Strip (2×4 Grid)

Eight key metrics displayed in a compact 2-row × 4-column grid:

Row 1 — Decision Levels (where to act):

Metric	Color	What It Is	How to Use It
Spot Price	White	Current market price	Your reference point
Gamma Flip	Gold	Level where dealer positioning flips	THE structural pivot — above = stable, below = volatile
Call Wall	Green	Strike with highest call gamma	Upside resistance — dealers sell into this level
Put Wall	Red	Strike with highest put gamma	Downside support — or trap door if breached

Row 2 — Context Metrics (what's happening):

Metric	Color	What It Is	How to Use It
Net GEX	Red/Green	Total gamma exposure in dollars	Positive = dealers long gamma (stable), Negative = short (volatile)
P/C Ratio	White	Put-to-call open interest ratio	>1.0 = more puts (bearish sentiment), <1.0 = more calls (bullish)
Max Pain	White	Strike where most options expire worthless	OPEX magnet — price tends to gravitate here near expiration
Vol Trigger	White	Level where dealer gamma balance shifts	Above = lower vol, below = higher vol

Each cell shows a percentage distance from spot (e.g., "0.5% from spot") to help you quickly assess proximity.

5. GEX Profile Chart

A large Plotly bar chart showing gamma exposure by strike price:

Green bars (right side) = Call GEX — brighter green = higher gamma concentration
Red bars (left side) = Put GEX — brighter red = higher gamma concentration
Gold line = Net GEX (calls - puts) — shows the overall dealer positioning per strike
Color intensity = The brighter the bar, the more significant that strike level is

Chart annotations: - PUT WALL (red label) — highest put gamma strike with % distance from spot - GAMMA FLIP (amber label) — structural flip level with % distance - CALL WALL (green label) — highest call gamma strike with % distance

Zone bands: - Faint green zone between spot and call wall = dealer support zone - Faint red zone between put wall and spot = dealer risk zone

Legend: Call GEX, Put GEX, and Net GEX are labeled at the bottom of the chart.

6. GEX Heatmap (Collapsed)

Click the "GEX Heatmap" bar at the bottom to expand a 1D heatmap showing net gamma intensity by strike:

Green tiles = Positive net gamma (support/stability)
Red tiles = Negative net gamma (resistance/volatility)
FLIP annotation marks the gamma flip level
Color scale on the right shows GEX values in millions

Click the bar again to collapse the heatmap.

Switching Symbols

Click SPY, QQQ, or IWM quick buttons for one-click access
Type any symbol (e.g., AAPL, TSLA, NVDA) in the input box and click Analyze
The entire dashboard refreshes with new data for the selected symbol

Data Sources

TaipTrade uses a multi-provider engine with automatic fallback:

Provider	What It Provides	Cost
Theta Data (primary)	Real-time option chains with OI and bid/ask quotes. IV is derived via Newton-Raphson solver from mid-prices.	$40/mo Value plan
yfinance (fallback)	Free option chain data. Occasionally returns 0 for open interest.	Free

The provider badge in the header shows which source is active. If Theta Data is unavailable, the system automatically falls back to yfinance.

How GEX Levels Are Calculated

Options chain data is fetched for all available expirations (nearest 6)
Implied volatility is derived from option mid-prices using a Black-Scholes Newton-Raphson solver
Gamma per strike is calculated: Gamma × OI × 100 × Spot²
Call GEX and Put GEX are computed separately (puts are negative)
Key levels are extracted:
Gamma Flip = Strike where net GEX crosses zero
Call Wall = Strike with highest absolute call GEX
Put Wall = Strike with highest absolute put GEX
Max Pain = Strike that minimizes total option holder payout
Vol Trigger = Strike where put gamma exceeds call gamma

Market Brief

Route: /briefer (requires login)

The Market Brief page displays AI-generated market briefings. These are structured analysis reports that cover market conditions, key levels, scenarios, and trading implications.

Viewing Briefs

The latest brief is displayed by default
Use the sidebar to browse all available briefs
Filter by report type (AM/PM/all)

Uploading Briefs

Click Upload Brief at the top of the page
Select a JSON file containing the brief data
The brief will be parsed and displayed

Briefs include sections like: overnight summary, primary market driver, regime classification, bullish/bearish/chop scenarios, and key support/resistance levels.

Settings

Route: /settings (requires login)

The settings page shows your account information:

Email address
Display name
Subscription tier (Free / Pro / Fund)
Account role (Admin / User)

Future features will include: subscription management, LLM provider preferences, notification settings, and investing style configuration.

Glossary

Term	Definition
GEX	Gamma Exposure — measures how much market makers need to hedge
Gamma Flip	Price level where dealer positioning changes from positive to negative gamma
Call Wall	Strike with the highest call option gamma — acts as upside resistance
Put Wall	Strike with the highest put option gamma — acts as downside support
Max Pain	Strike price where the most options expire worthless — price gravitator near OPEX
Vol Trigger	Level where put gamma starts exceeding call gamma — marks volatility transition
P/C Ratio	Put-to-Call open interest ratio — >1.0 indicates bearish positioning
Net GEX	Total gamma exposure (call gamma minus put gamma) in dollar terms
Regime	Current market state based on GEX: Positive Gamma (stable) or Negative Gamma (volatile)
FIFO	First-In, First-Out — method used to match buy and sell orders into trade pairs
Deduplication	Automatic detection and skipping of trades already in the database
Realized P&L	Profit/loss from trades that have been closed (both entry and exit matched)
Unrealized P&L	Estimated profit/loss on open positions based on current market prices
Black-Scholes	Mathematical model used to calculate option prices and Greeks (gamma, delta, etc.)
Newton-Raphson	Numerical method used to solve for implied volatility from option prices
Open Interest (OI)	Number of outstanding option contracts at a given strike price
Implied Volatility (IV)	Market's expectation of future volatility, derived from option prices

User Manual