Getting Started

How TradeGrade works

A walkthrough of every tab, using a real sample week of trading data — so you know exactly what you're looking at before your own numbers are on the screen.

01

Calendar

Your trade journal's home base. Every trade you import lives here, organised by day, with your running stats always visible.

Every bold date on the calendar has trades logged against it. Click any date to see the full breakdown for that day — every execution, gross and net P&L, and the notes you've written. The stat cards along the top update automatically as you select different dates: day, week, month, and year figures side by side, so you're never just looking at one number in isolation.

TradeGrade Calendar tab showing daily stats, trade detail, and import tools
Calendar — 08/17/2026 selected, showing 1 closed trade and the day's full P&L breakdown
The "From Session Tracker" box is worth knowing about. If you logged this day's trades live in Session Tracker (not just imported them after the fact), you'll see a read-only summary of your per-trade emotions right in the Calendar view — pulled directly from what you tagged in the moment. It's never editable here; it's just a reminder of what you were feeling when you actually took the trade.

Four ways to get trades in

TradeGrade isn't built around any one broker. IBKR gets automatic format detection since it's common among momentum traders, but every path below works regardless of who you trade through.

Paste your execution log

Paste a tab-separated list — Time, Symbol, Action, Qty, Price, Commission — into the Import box. This matches Interactive Brokers TWS's paste format out of the box; if your platform exports executions in the same column order, it'll work too.

Import from CSV

Upload a CSV file. IBKR Activity Statement exports are detected and parsed automatically. On any other broker, export to TradeGrade's own generic format instead — Date, Time, Symbol, Side, Qty, Price, P&L, Commission — the same structure "Export Period CSV" produces, so it's already proven to re-import cleanly.

Screenshot Import

Drop or paste a screenshot of your broker's execution log — genuinely broker-agnostic. AI reads the image and extracts the trade data, which makes this the most reliable option if you're not on IBKR and don't want to reformat a CSV by hand.

Daily Notes

Free-text notes per day. These feed into "Review My Progress" on the AI Analysis tab as qualitative context — write what the numbers can't show.

Full Backup (JSON) vs Export Period CSV. The CSV export is trade data only, for whatever date range you've selected. The full JSON backup is the only export that includes your session history, checkpoints, rules, and settings — that's the one to use if you're moving to a new device or just want real peace of mind.
02

Dashboard

The pattern-recognition layer. Where Calendar shows you individual days, Dashboard shows you the shape of your trading over time.

TradeGrade Dashboard tab showing weekly target, rolling win rate, hold time, and performance charts
Dashboard — Weekly Target, Rolling Win Rate, Win/Loss, Daily Performance, Hold Time, Drawdown, and time-based breakdowns
  1. Weekly Target sits at the top for a reason — it's tied to whichever week you last selected on the Calendar, and tracks your red-day count against your configured cap, not just a raw dollar figure. Red days are the lever that actually matters here, not the total.
  2. Rolling Win Rate smooths out single-day noise — the blue line is your trailing win rate over your chosen trade window (10/20/30/50), plotted against your overall win rate as a reference.
  3. Hold Time (Winners vs Losers) is one of the most honest charts in the app. If your losers are held longer than your winners, that's the single clearest tell of a discipline problem — and it's staring right at you here, not buried in a spreadsheet.
  4. Performance by Hour / Day of Week / Month — these exist to catch patterns you can't see day-to-day: a bad Tuesday habit, a specific hour where your edge disappears, a slow bleed across a whole month.
Edit Layout. Every widget on Dashboard, Reports, and Session Tracker can be reordered or hidden — click "Edit Layout" in the top right of any of those three tabs. Drag to reorder, click the eye icon to hide something you don't use. Your layout is saved per tab and persists across sessions.
03

Reports

Where Dashboard shows trends, Reports lets you interrogate a specific period — and ends with the single number that ties the whole app together.

TradeGrade Reports tab showing period charts and the discipline score breakdown
Reports — 30-day view with Daily/Cumulative P&L, Volume, Win %, distribution, streaks, and the Discipline Score Breakdown

Use the period buttons (30D / 60D / 90D / 180D / All) and the Daily / Weekly / Monthly granularity toggle to zoom in or out on exactly the window you want to review. Win/Loss Distribution buckets your trades by size in $5 increments near zero, widening further out — so you can see at a glance whether your losses cluster tightly (good sign) or have a long ugly tail (worth investigating).

Discipline Score Breakdown is the number that matters most. It's not your win rate and it's not your P&L — it's a weighted score built from loss limit respect (40%), trade cap (20%), cooldown compliance (20%), volume cap (10%), and profit target discipline (10%). A green month with a low discipline score is a warning, not a win.
04

Session Tracker

The only tab you should have open while you're actually trading. Everything else in TradeGrade is review — this is real-time.

TradeGrade Session Tracker tab showing the timer, identity declaration, trade inputs, checkpoints, and rules
Session Tracker — live layout with Session Timer, Identity Declaration, Trade P&L, Capital Deployed, Live Metrics, Checkpoints, Discomfort Log, Warnings, and Trading Rules
  1. Start the Session Timer before your first trade. The banner at the top ("Continue Session" / caution / stop) mirrors your real-time rule status and updates the instant you enter a trade.
  2. Log each trade in Trade P&L as you close it — a new box appears automatically. Tag the emotion(s) you felt on that specific trade from the dropdown next to it; this is what powers the emotional trend tracking later.
  3. Tick checkpoints as they become relevant — see below, this is worth understanding properly.
  4. Use the Cooldown timer after every loss. Its duration is the one setting that stays editable all session, even while everything else is locked — because how long you need to reset can genuinely change trade to trade.
  5. End & Log when you're done. This is what actually saves the session, feeds it into Session History, and makes it available for AI Analysis.

Every widget, what it actually does

The layout above is just one arrangement — every card here can be moved or hidden via Edit Layout. What each one does stays the same regardless of where you put it.

Daily Identity Declaration

Write and speak one sentence defining yourself as a trader, before you look at a single chart. This exists because willpower fails under pressure but identity is harder to abandon mid-trade — "I don't do that" holds up better in the moment than "I shouldn't do that."

Trade P&L

Enter each trade's result as you close it — negative numbers for losers. Each entry has its own emotion tag dropdown right next to it, multi-select, so one trade can carry more than one tagged feeling if that's honest.

Capital Deployed

A separate widget, but linked to Trade P&L one-for-one — box 3 here corresponds to trade 3 above. This is what your Volume Cap is actually measured against, not your P&L entries.

Live Metrics

Current P&L, Return on Capital, Drawdown from Peak, and Session Discipline — the same weighted score used everywhere else in the app, calculated live as you trade rather than only after you log.

Loss Checkpoints + Cooldown

Tick milestones as you hit them, and start the cooldown timer after every loss — see below for exactly what's required versus optional here, and why cooldown is the one exception to the lock.

Profit Checkpoints

Includes the Green-Day Continuation Exception — tick it only when a trade past your cap was genuine continuation on an already-profitable symbol at normal size, not a fresh speculative position. The AI verifies this against your actual trade data rather than trusting the tick.

Discomfort Log

The hardest moment you felt an urge to break a rule, and what you actually did instead. This is the one piece of Session Tracker data that feeds into "Review My Progress" on the AI Analysis tab as qualitative context.

Active Warnings & Triggers

A live readout, not a summary — green means everything's within limits right now, amber means you're approaching a limit, red means a hard limit has already been breached. The banner at the top of the page always mirrors whatever this card says.

Objective vs. discretionary checkpoints

This distinction is the whole point of how checkpoints are graded, so it's worth understanding rather than just clicking boxes.

CheckpointTypeWhat it means
Hit daily loss limit → Session overObjectiveTied to a real number. Flagged if missed.
Hit profit target → Consider stoppingObjectiveTied to your configured profit target. Flagged if missed.
Gave back 20%+ of peak gains → Tighten stopsObjectiveTied to your actual configured giveback %. Flagged if missed.
Loss #1 / #2 / #3 → Take a break, etc.DiscretionaryA judgment call. Never flagged as missed, whether ticked or not.
First green trade → Size downDiscretionaryA judgment call. Never flagged as missed, whether ticked or not.
Only objective checkpoints ever generate a "missed" flag — in the AI report, in Session History, and in the quick preview on the AI Analysis tab. Discretionary ones are there for you to use as a personal reminder, not something the app will hold against you for skipping. Any checkpoint you add yourself defaults to discretionary — it won't be held against you unless you're using one of the three built-in objective ones above.

What locks once the timer starts, and what doesn't

Session Tracker deliberately prevents you from quietly loosening your own rules mid-session. Once the timer is running:

Locked while tradingStays editable
All Trading Rules values (caps, limits, targets)Cooldown duration — the one exception
Adding, editing, or removing any checkpointTrade P&L / Capital Deployed entries
— locked buttons show "Locked during session"Identity Declaration, Discomfort Log, Notes

Cooldown duration is exempt on purpose — the right length genuinely varies trade to trade. A bigger loss or a hotter emotional state might call for longer than your default; a minor slip might not need the full window. Everything else stays fixed once you've committed to it, specifically so a bad moment mid-session can't talk you into redefining your own limits.

Trading Rules — every setting, and what it actually controls

Click "Customise" on the Trading Rules card to set these. They're the numbers every other part of the app — Live Metrics, Active Warnings, the Discipline Score — is measured against.

SettingWhat it does
Trade Target / Trade Hard CapTarget is a soft amber warning to wind down. Hard Cap is a red stop signal.
Volume Target / Volume Hard CapSame soft/hard pattern, measured against Capital Deployed, not P&L.
Max Shares Per TradeMaximum position size for any single trade.
Daily Loss LimitRed stop signal — and the single biggest factor in your Discipline Score (worth 40 of 100 points, graded by how far over you go).
Profit TargetAn amber nudge to consider locking in gains — not a hard stop.
Max DurationMinutes on the countdown timer.
Giveback % TriggerThe % of peak P&L given back that triggers a red stop.
Giveback Activation ThresholdYour peak must reach this dollar amount first — stops the rule firing on tiny early gains.
Min Loss Before GivebackThe minimum dollar amount given back before the rule can fire at all.
Giveback Warning %An earlier amber heads-up, before the red trigger point.
Weekly Target ($)A reference line on the weekly chart — evaluated at week's end, not paced day by day.
Weekly Red-Day CapThe real weekly discipline target — how many red days you're allowed before the week itself goes amber or red. The dollar figure is secondary to this.
Discipline Score weighting, in full: Loss limit respected — 40pts · Trade cap respected — 20pts · Cooldown compliance — 20pts · Volume cap — 10pts · Profit target discipline — 10pts. A loss-limit breach is graded by severity rather than all-or-nothing: 0–10% over still scores full points (normal slippage), 10–20% costs 10 points, 20–30% costs 15, and anything past 30% costs all 40 and effectively caps the session's score.
Session Tracker with Session History detail expanded for a specific date
Session History — a completed session, with checkpoint compliance shown per item

Session History, at the bottom of Session Tracker, is where every logged session lives. Select a date to see the full detail: score, checkpoint compliance, and — if you filled them in — your Daily Identity Declaration and Discomfort Log for that session.

Editing a session after the fact

Mistakes happen after you've already logged — a wrong number, a missed checkpoint tick. Click Edit on any session in Session History and it loads back into the live tracker exactly as it was originally entered, page scrolled to the top automatically.

While editing, the normal Start / Pause / Reset / End & Log controls are disabled — Save Changes and Cancel are the only way out, on purpose, so you can't accidentally start a new live session on top of a correction. Saving writes the fix back into that exact session — it never creates a duplicate. Cancelling discards everything and touches nothing. Either way, the tracker always ends up back in a clean, blank state, ready for your next real session.
05

AI Analysis

The tool's actual thesis: grading your process, not your P&L — with real pushback when the two disagree.

AI Analysis tab before running analysis, showing the derived-from-journal preview and session tracker summary
AI Analysis — before running. Trade data is pulled automatically; the session summary shows checkpoint compliance at a glance
  1. Select a trading day. The "Derived from Journal" and "Session Tracker" cards populate automatically — this is exactly what gets sent to the AI, so you always know what it's working from.
  2. Write a self-assessment (optional, but worth doing). This is where the AI's honesty actually shows up — if you write "I stayed disciplined today" and the data shows a rule breach, it will say so directly, not politely agree with you.
  3. Upload chart screenshots (optional). Hold the crosshair over your key level — HOD, entry zone, pivot — with price and time visible, for the most useful read.
  4. Click Analyse This Session.
A completed sample AI analysis report showing Verdict, 5 Positives, Areas for Improvement, and Rules Compliance
A completed report — Verdict, 5 Positives, Areas for Improvement, Rules Compliance, and more below the fold

A finished report always follows the same structure: a Verdict with a letter grade, 5 Positives — genuine ones only, never padded to hit the number — and Areas for Improvement, both grounded in specific numbers from your actual session, not generic advice. Below that: a full Rules Compliance pass/fail table, a Discipline Trend comparing your recent sessions to your earlier ones, and a Self-Assessment Check that directly compares what you wrote against what the data says.

5 Positives doesn't mean 5 every time. On a genuinely bad session, the report will say plainly that there's little to point to — it won't invent praise to fill the section. The flip side: it actively looks for real progress even on rough days, like a loser that was cut fast despite an otherwise undisciplined session.
Review My Progress is a separate button next to Analyse This Session — it looks across your whole history rather than one day, and is the only place your Daily Notes and Discomfort Log entries get pulled in as qualitative context alongside the numbers.