QuantAscent — Screen Guide¶
Last updated 2026-11-11
A detailed reference for every tab and dialog in the QuantAscent desktop app.
See also: Product Overview for a feature summary | Setup Guide for installation and IBKR configuration
Navigation¶
The sidebar on the left groups the app's tabs into three collapsible sections, with Settings below them:
- Strategy Lab — Library, Research, Adaptive Builder, Static Builder, Backtester: where strategies are researched, designed, tested, and cataloged
- Company Research — Company Analysis, Company Screener: single-company analysis and universe screening
- Portfolio — Dashboard, Strategy Manager, Holdings, Strategy Performance, Trade Log, Account: your money
- Settings
Click any tab name to switch views; click a section header to collapse or expand that group. The Portfolio section header also holds the portfolio switcher dropdown, the active portfolio's money-type label, and a Manage Portfolios link that opens the portfolio management dialog.
On a brand-new install the app opens on the Library (the Strategy Lab's front door); after that it opens on the Dashboard.
At the bottom of the sidebar, status pills show notifications and the IB Gateway connection (green means connected, gray means disconnected — click it to open the connection setup wizard). A Help & About link sits under the logo.
Most screens auto-refresh when underlying data changes (for example, after the scheduler runs a portfolio sync). You do not need to manually reload.
Strategy Lab¶
The Strategy Lab section is where strategies are designed and tested. Nothing here touches your money — a strategy only trades after you add it to the Strategy Manager (in the Portfolio section) and confirm a rebalance there.
1. Library¶
The Library is the catalog of every strategy in the app — the ETF trackers plus your own. Three sub-tabs organize the catalog:
| Sub-tab | What's in it |
|---|---|
| ETFs | Single-ETF trackers for broad indexes, sectors, bonds, commodities, and more |
| Adaptive Strategies | Your adopted walk-forward processes — strategies whose rules are re-derived by the process that created them |
| Static Strategies | Your own fixed-rule strategies — Percentile and Fixed Allocation, including deployed fixed-allocation baskets |
ETFs¶
Single-ETF trackers for broad indexes (S&P 500, NASDAQ-100, Russell 2000), sectors, bonds, commodities, international markets, and more. These are allocations, not strategies — each one holds exactly one ETF. Cards show performance chips, an equity-curve chart, and backtest links, sortable by name (the default) or by performance keys you pick. A Time span row (1Y / 3Y / 5Y / 10Y / All) re-windows every card's chips and chart — and the active sort — to the trailing window, computed the same way as the Backtester's timeframe buttons (Recent 4Q always means the trailing four quarters). Each card has two actions:
- Add to Strategy Manager — the ETF becomes its own new sleeve; same review-and-confirm dialog as everywhere else
- Add to Fixed Allocation — put the ETF inside a fixed-allocation strategy: pick what % of your portfolio it should hold, then add it to an existing fixed-allocation strategy (deployed ones included) alongside what it already holds, or start a new basket with it. Nothing changes until you confirm
Adaptive Strategies¶
Your adopted walk-forward processes — their rules are re-derived by the process that created them. Each card shows a badge, the strategy's deployment status (Deployed → the sleeve running it), a facts line, and actions:
- Open in Adaptive Builder — the process run lives in the Adaptive Builder's history list
- Rename / Delete
- Add to Strategy Manager — attach the strategy to an existing sleeve or a new one; no trades are placed until you run a rebalance and confirm the orders
If a process derived a rules change at its last derivation, the card shows a Rules change pending note — review and accept or decline it in the Strategy Manager (see Adaptive Strategy Rules Proposals); nothing changes until you do.
Static Strategies¶
Your own fixed-rule strategies. Each card shows a sub-type badge (Percentile or Fixed Alloc), deployment status, a facts line, and actions:
- Edit — opens the strategy in the Static Strategy Builder (Fixed Allocation entries open in its Fixed Allocation editor)
- Rename / Duplicate / Delete
- Add to Strategy Manager — same review flow as above
Deployed fixed-allocation baskets appear here too — Edit opens their editor, while allocation, archive, and delete live on their Strategy Manager card.
Tips¶
- The Library is the app's landing page and the catalog of everything you build: click Edit on one of your own cards to continue working on it, or head to the Adaptive or Static Builder to design something new.
- The ETFs tab covers the hands-off half of a portfolio — add a tracker as its own sleeve, or fold it into a fixed-allocation basket alongside your own strategies.
2. Research¶
Research (sidebar: Research) is where a strategy starts. You define a universe, see what that universe is, find the metrics that have lined up with returns inside it, and check how a saved strategy's filters and scoring behave there — static and adaptive strategies alike. It is organized as three steps, left to right, under the matrix row:
- Universe — the filter editor and a profile of the universe it defines
- Signals — which metrics have historically predicted returns in that universe
- Combine — how a saved strategy's filters and composite score behave in it
A one-line universe chip above the steps names the universe every number on the page describes. Click it to return to the Universe step. After you change the universe, opening Signals clears the IC table, the Independent signals card and the metric detail and recomputes them for the new universe; opening Combine does the same for a Score Analysis or Score Breakdown you have already run.
The matrix row names the matrix every step reads. A weekly data pack replaces the included matrices with files named for their new window. When a pack lands while the app is open, Research reloads the matrix it had open with that file's successor on its own, says so in its status line while the load runs, and the Static Builder's insight panel and the Company Screener follow.
For a deep dive into the methodology behind these tools, see the Research Analysis document.
Universe step¶
Editor. Market cap and share price ranges, a Dollar Volume floor, the Fresh Filings screen, sector / industry / country / exchange filters, and metric filters. The dollar-volume floor keeps only companies whose average daily dollar value traded over the past three months is above the amount; it applies only to a matrix that carries trading volume, and on an older matrix the control is disabled and says so. Fresh Filings is on at 135 days by default: only companies whose latest financial statements were filed within that window are included, and companies with no filing-recency data pass. Set it to 0 to turn the screen off. Import copies a saved strategy's filters into the editor; Export writes the editor's filters into a saved strategy.
Profile card. Seven tiles describe the universe itself, each with its definition in a tooltip:
- Breadth — companies per rebalance date: the median quarter and the thinnest quarter.
- Base rate — what owning every company in the universe, equal weight and re-formed each rebalance date, returned per year, with its volatility and worst drawdown, next to the whole market (every company passing the freshness screen) and SPY over the same windows. This is the Backtester's Filtered Universe line.
- Single-pick odds — per company and quarter: the share that ended the quarter up, the average gain when up, the average loss when down, the share that doubled, the share that lost half or more.
- Dispersion — the gap between a top-fifth and a bottom-fifth outcome in a quarter, averaged across dates. What a ranking has to work with.
- Stable signals — metrics whose IC keeps the same sign in both halves of the date range with enough data in each half, and the strongest of them. The Adaptive Builder uses the same halves.
- Data quality — the survivorship-honest window (dead companies are in the data from 2016 on), the share of rows the freshness screen removed, the share priced under $5 as traded, and how many metrics have enough data here.
- Tradeability — the median company's average daily dollar value traded over the past three months and the 10th percentile. Appears once the data pack carries volume.
Two charts follow: names per quarter, and $1 held equal-weight in this universe against the whole market and SPY.
Sector × size grid. Eleven sectors by five market-cap bands, plus All margins, one measure at a time: names per quarter, base rate, share up next quarter, dispersion, metric coverage, stable signals, strongest stable IC. A sentence under the Measure dropdown says what the chosen measure is. The grid keeps every filter in the editor except sector and market cap. Click a cell to make it the universe; the pointer becomes a hand over a cell, and a notice at the bottom of the page names the universe the click set, with Undo and Show editor buttons, until it goes away on its own. Cells with fewer than ten names per date are greyed. The two signal measures compute on demand and take a minute or two the first time for each matrix.
Signals step¶
IC Rankings. Every metric ranked by how closely its values have lined up with subsequent returns inside the universe above (its information coefficient), with a 95% interval, p-value, direction, sample size and a Stable mark: ✓ when the IC keeps the same sign in both halves of the date range with enough data in each half, ✗ when it does not, — when the metric was not ranked in both halves. The chart shows the top three metrics per factor family with their intervals. Compare to switches the IC from the whole market (how strategies are scored) to sector or sector-and-size peers, an attribution view. Exclude $ metrics hides dollar-denominated size proxies.
Metric detail. Click a row or a chart bar, or search a metric, and the pane below fills with four cards:
- IC over time — the IC on every rebalance date, the average as a line, the second half shaded, the two half-ICs in the caption.
- Quintiles — stocks split into five groups by the metric on each rebalance date, each group held as an equal-weight portfolio re-formed every date. The bars are each group's compounded return per year, the same measure as the base rate, with the Q5−Q1 spread in points per year. The table adds the typical (median) name's return, the share of names that went up, the worst period and the count. A sentence under the chart says whether the fifths line up in order and what to do about it, and a warning names a group whose plain average is carried by a few extreme names.
- Where it works — the IC inside each sector and each market-cap band, with the number of names in brackets.
- Rule preview — keep only the companies that pass a rule, re-applied on every rebalance date the way the backtester applies a filter. The controls read as a sentence: Share of the universe · keep the top (or keep the bottom) · 17% of the universe, or Fixed value · greater than (or less than) · 0.163. One sentence states the rule and how many companies pass on a typical date. Four tiles give the average return per period of the companies that pass, the same for the whole universe, the difference in percentage points with its 95% range, and how many rebalance dates the passing companies were ahead. A line under the tiles says whether the range stays above zero, stays below zero, or includes it. Two charts follow. The left one puts the metric's own percentile on the x-axis, highest values at the right, and shows how the difference changes as the cutoff moves, with its 95% range as a band. The cutoff is marked and the side that is kept is shaded, so keeping the top 10% is a line at the 90th percentile with the 10% to its right shaded, and moving the slider moves the line along the curve rather than drawing a new picture. The right one shows the difference on each rebalance date for the current position, green when the passing companies beat the universe and red when they trailed it, with the average as a dashed line; its scale is fixed from the whole curve, so a weaker position shows smaller bars. Add as filter… writes the rule into a saved strategy as a hard gate (a share rule becomes a universe floor); Add as scoring criterion… adds the metric to its composite score. Both offer static strategies and adopted built-ins only: an adaptive strategy's rules are re-derived by its process, which would overwrite a rule written by hand.
Independent signals. Under the IC table: the 20 strongest metrics that pass both of the table's reliability checks (the IC's 95% range excludes zero, and its sign held in both halves of the date range, the Stable mark), grouped into signals. The metrics are taken from the strongest |IC| down; each is turned the way its IC points and rank-correlated, across the companies on each rebalance date and averaged over dates, with the metric at the head of every signal so far. Under 0.7 with all of them, it starts a new signal and gets a row; otherwise it is listed under the signal it correlates with most, in the Also this signal column with that correlation. The signals' metrics are therefore under 0.7 with each other, and the headline counts them and says how many unrelated metrics would carry the same ranking information ("11 signals at the 0.7 rule among the 20 strongest reliable metrics, together about 4 independent signals' worth of ranking information"). That second number is the signal count squared over the sum of the squared correlations in the grid: unrelated signals count in full, signals that are alike without reaching 0.7 bring it under the count. A line under the headline states both rules, the effective count to one decimal, and how many of the ranked metrics are reliable. Beside the table, a grid of the signals' pairwise correlations, numbered like the rows: a distinct pair (under 0.3) stays dark, a pair that ranks the companies alike is amber, deeper the more alike, and a pair that ranks them in opposite orders is red. The key under the grid names each step in words, and the line under the key says that paler pairs add more to each other; point at a cell and that line names the pair, its correlation and the share of top-tenth picks the two have in common on a typical date. Hover a listed metric for its own IC, 95% range and half ICs and the same sentence against its signal's metric; click a row or a listed metric to open that metric's detail below. Notes under the card count pairs that rank alike across signals (a listed metric at or above 0.7 with another signal's metric; it stays under the signal it ranks most like), name signals that rank in opposite orders (both stay), and name metrics the matrix lacks. The card describes overlap among the reliable metrics in this universe and is not a recommendation: the set changes with the universe, and a metric listed under a signal can be the better choice for other reasons.
Combine step¶
Pick a saved strategy in the Strategy dropdown. The two cards under the panel describe the strategy itself; Score Analysis and Score Breakdown below them test its composite score inside the universe above. An adaptive strategy can be picked too. A line above the panel then says that what is analyzed is the rule set its process derived last, with the date, applied to every date in the matrix, and that the test of the process is its walk-forward record on the Adaptive Builder's Records page.
Filter funnel. The strategy's filters applied one at a time, in the order the backtester applies them: market cap, share price, dollar volume, fresh filings, categories, each metric filter, each percentile floor. Each stage reports the names left per rebalance date, the share of the whole matrix left, the equal-weight return per year of what is left, and its hit rate. The stage that removes the most names, or moves the return per year the most, is the filter doing the work. The table and the bars say the same thing.
Redundancy. Every pair of metrics the composite score reads, rank-correlated across the companies on each rebalance date inside the strategy's filtered universe and averaged over dates, drawn as a grid with each metric's factor family and the direction the score reads it in (higher is better, lower is better) beside its name. Every row carries its number and that label to the left of the cells, whatever the count: on two lines beside the larger cells of six metrics or fewer, on one line beside the smaller cells of more. Before the correlation is taken, each metric is turned the way the score reads it (a lower-is-better criterion is flipped), so +1.00 means two metrics put the companies in the same order, and a low-volatility metric and a quality metric that pick the same companies read as alike, not opposite. The line above the grid counts the pairs that rank the companies alike (0.7 or more: the score counts one signal twice; five value metrics that rank companies the same way are one signal weighted five times) and the pairs that rank in opposite orders (−0.7 or under: the score rewards what the other penalizes). A distinct pair (under 0.3) stays dark, a pair that ranks the companies alike is amber, deeper the more alike, and a pair that ranks them in opposite orders is red. A key under the grid names each step in words, and the line under the key says that paler pairs add more to each other; point at a cell and that line names the pair, its correlation and the share of top-tenth picks the two have in common on a typical date. A strategy with one scoring metric says so, names its metric filters as gates rather than scores, and points to the Signals step's Independent signals card, which draws the same grid for the strongest reliable metrics of the IC table. A strategy with no scoring metrics says so instead. The grid describes the inputs; two metrics that rank alike can be kept on purpose.
Score Analysis¶
Test a complete composite scoring system — the same one you build in the Static Strategy Builder. See how the composite score's IC varies across sectors, market cap bands, and time periods.
Score Breakdown¶
Analyze how individual criteria contribute to the overall composite score. Identify which criteria are pulling their weight and which are adding noise.
Build Matrix¶
Before using Research, you need a built metrics matrix. A Build Matrix button at the top triggers the computation (runs in the background with a progress bar). The matrix is saved locally and only needs to be rebuilt when you want to incorporate newer data.
Tips¶
- Start with IC Rankings, then click the strongest stable metrics to see their detail. A high IC that is not stable was earned in one half of the data.
- A metric with a high IC but a flat middle in the quintile chart works at one end only: preview a percentile rule on that end rather than scoring the whole range.
- "Where it works" shows a metric that works in one sector and not another; a sector filter in the Universe step turns that into a universe.
- Export… on any card writes that card's table as a CSV file: the numbers as shown, with the matrix, the universe and the time in lines starting with # above the header. The Company Screener has no export: its rows are licensed data.
3. Static Strategy Builder¶
The Static Strategy Builder (sidebar: Static Builder) is the editor for static strategies — fixed rules you edit directly: Fixed Allocation and Multi-Factor: Percentile. Open a saved strategy with the toolbar's Open button or from its Library card's Edit button, or start a new one with New. To find the universe and the metrics for a strategy, use Research; to test a strategy against history, run it in the Backtester.
The page's layout:
- Strategy type selector — choose what kind of strategy to build
- Strategy selector bar — Open, New, Reset to defaults, Save and Save As; the label names the open strategy
- Editor panel — configure the strategy's rules and parameters
Strategy Type Selector¶
A dropdown offering two types:
| Type | Description |
|---|---|
| Fixed Allocation | Set target weights for specific tickers |
| Multi-Factor: Percentile | Score stocks by their percentile rank on each metric |
A description below the dropdown updates to explain the selected type.
Strategy Selector Bar¶
Buttons across the top for managing the loaded strategy:
- New — start a blank strategy
- Reset to defaults — every setting on the page back to a new strategy's values (the Filters card, Portfolio, Lookback); the name and the scoring criteria stay, and nothing is written until you Save
- Save / Save As — persist your work
- Delete — remove the loaded strategy
- Copy to Portfolio — copy the strategy into another portfolio (for example, promoting a paper-tested strategy to live)
- Add to Strategy Manager — add the current strategy to the Strategy Manager. The dialog shows the strategy's full rule set for review before you confirm, and lets you create a new sleeve or replace the strategy in an existing one
- A status indicator shows whether you have unsaved changes
Rename and Duplicate live on the strategy's Library card.
Editor Panel (Multi-Factor: Percentile)¶
The left side of the screen where you define your strategy's rules:
Criterion cards — each card represents one scoring rule. On each rebalance date every stock in the universe is ranked on each criterion's metric, the ranks are weighted and summed into a composite score from 0 to 100, and the highest composite scores are held:
- Metric — choose from 150+ financial metrics (grouped by category)
- Direction — whether a higher or a lower value ranks better
- Weight — how much this criterion contributes to the composite score (weights are normalized to sum to 1)
- Percentile bounds (advanced) — score only the part of the ranking between a floor and a ceiling
- A cross-metric criterion compares two metrics instead (a > b or a < b) and scores 100 when the comparison holds, 0 otherwise
Filters — narrow the stock universe before scoring:
- Sector, industry, market cap range
- Metric filters — hard gates in one list, each with a threshold that is either a fixed value (e.g., exclude stocks with negative earnings) or a percentile: keep the highest or lowest N% of the universe by that metric, with the cutoff value recomputed from each rebalance date's universe rather than fixed. Ties at a percentile cutoff are kept, and a percentile filter is skipped on dates where fewer than 20 stocks carry its metric.
- Multiple percentile filters each cut the same reference universe (the universe after the fixed filters), and only stocks passing all of them are kept — overlapping cuts can retain far fewer than any single one. Percentile filters apply to trading, rebalances, and backtests; Score Analysis and IC previews evaluate the universe before percentile filters.
- The per-date median screen of an adopted adaptive strategy appears in the same list, tagged. It can be removed but not edited in place; which side it keeps follows the metric's learned direction.
- Fresh filings — only score companies whose latest financial statements were filed within N days (adaptive processes use 135). Unlike a metric filter, companies missing filing-recency data pass rather than being excluded. Off by default on new strategies.
On adaptive strategies the filters list and the freshness screen show read-only, since the process re-derives them at every rebalance.
Portfolio parameters:
- Max Stocks — how many of the highest-scoring stocks to hold (10 to start); the universe is the only other limit
- Rebalance window (how often to re-evaluate)
- Stock Selection — how stocks are ranked when scoring: Whole market (rank every metric across the full universe, the default), Sector peers, or Sector + size peers (rank each metric within its peer group first, so you select on a stock's standing relative to comparable companies rather than the whole market). The picture under the choice shows what it does: schematic companies in three sectors and three size bands, in rank order from best on the left, with the picks ringed. Ranked against the whole market, the picks land in whichever sector scores highest; against sector peers, each sector competes with itself and the picks spread; against sector and size peers, they spread across sizes too.
- Amount per Stock — how the strategy's money is split among its picks. Equal amounts gives every pick the same share. By company size tilts the money toward larger or toward smaller companies by their market value on the buy date, with a slider for the share of the money that follows size; the rest is split equally, so every pick keeps at least its equal part. At the top of the slider all of the money follows size: toward larger companies that is each pick held in proportion to its market value, the rule the S&P 500 uses. The picks never change, only the amount each one gets. Under the control, a bar shows the share of the money each pick gets under your setting (equal shares under equal amounts), with the largest position, the smallest position and the effective number of holdings beside it. Before a run the bar is an illustration: companies spread evenly across the size range of the universe your filters leave on the pack's latest date, not a forecast of the picks. In our own sweeps, ten stocks held in proportion to market value put about half the money into the largest pick, and thirty stocks about a third; holding more stocks spreads it.
Metric insight panel — when you pick a metric in the Add or Edit Criterion dialog, a panel under the fields shows that metric's IC (predictive power) and its five fifths, each held as an equal-weight portfolio re-formed every rebalance date, with the compounded return per year on each bar: the same measure as the Research page's Quintiles card. A sentence under the bars says whether the fifths line up in order and, when they do not, names the filter to add instead of a scoring criterion; a warning names a fifth whose plain average is carried by a few extreme names. Use it to gauge whether the metric is worth including before running a full backtest.
Editor Panel (Fixed Allocation Mode)¶
A simpler table-based editor:
- Add tickers and assign target percentage weights
- Weights must sum to 100% (or less, with the remainder in cash)
- Rebalance cadence isn't set here. It belongs to the strategy once it's in the Strategy Manager, the same as for scoring strategies
- To test a basket against history, pick it in the Backtester. Saved baskets and deployed fixed-allocation strategies both appear there
Tips¶
- The metric insight panel saves time: if a metric's IC is near zero, it's probably not worth adding as a criterion. If its fifths do not line up in order, the sentence under them says which end works and to add the metric as a filter rather than score it.
- Build from a blank canvas, or duplicate one of your existing strategies from the Library and rework it here.
4. Adaptive Strategy Builder¶
The Adaptive Strategy Builder (sidebar: Adaptive Builder) is where you design a process of your own — you author the rules, and the software's only job is to run them walk-forward and score the result. Nothing is suggested or pre-selected: the choices that have no default start blank, and pressing Run Walk-Forward before they are made outlines each one in amber instead of running. The outlines clear as you make the choices.
Three steps:
- Define your universe — Whole Market or specific sectors, plus optional market-cap and share-price ranges (share price is the price as traded on each date, not adjusted for later splits; the minimum starts at $1, and setting it to 0 includes stocks under $1), an optional dollar-volume floor (average daily dollar value traded over the past three months, in millions per day; it applies only to data that carries trading volume), plus optional metric filters: hard gates on any metric, against a fixed value (EarningsYield > 0) or against another metric (CurrentROE > MeanReturnOnEquity). A stock missing the metric is excluded. Filters are part of the universe — the random comparison portfolios are drawn from the same filtered pool, and the derived trading rules include them. (Universes reaching below $300M market cap add a factual liquidity disclosure to results — never a blocker.)
- Assemble your structure — pick one or more tilt templates (selecting several blends them equally), the Equal Weighting design on its own (it never blends with the tilts), or build a custom composition of factor clusters with your own weights totaling 100%. Every custom slot carries a fill rule you choose: strongest qualifying signal (largest stable signal in the slot's cluster), most consistent across halves, or a metric you pin. Set the holdings count: 5 or more, with no upper limit. The universe is the limit: a quarter with fewer qualifying names than the count holds every name that qualified, and the random-portfolio comparison needs at least the count on every quarter, so a count above the universe leaves the record without a standing against luck. Two more settings sit under the count, each with a picture of what it does: Stock selection, the peer group every stock is ranked against when the process scores a quarter (the whole universe, its own sector, or its own sector and size band), and Amount per stock, how the money is split among the picks (equal amounts, or by company size toward larger or smaller companies, with the share of the money that follows size). Both are part of the process: the record title says "by size" when the money followed size, the record page adds the largest position and the effective number of holdings, and the random portfolios the record is graded against split their money the same way. The Static Strategy Builder section above describes both controls.
- Set your selection rules — bounded settings: training window, stability gate, minimum signal strength, re-learn cadence, and the universe-floor options. The rules that keep labels honest (economic direction, cluster taxonomy, coverage, freshness) aren't adjustable — every judgment call is yours.
Run Walk-Forward draws the record live, quarter by quarter, as it computes: at each quarter the process re-derives its picks using only data available then, holds them one quarter, and chains the returns. Quarters where nothing qualified under your rules show as stood aside — the process held cash while the benchmark kept compounding, and the record says so.
Results show the record chart with stat tiles (CAGR, benchmark CAGR, excess, Sharpe, max drawdown, win rate, and a universe equal-weight comparator), an integrity line (random-portfolio percentile, weight robustness, and — for a candidate promoted out of a sweep — the size of the field it was picked from), and the full process echoed back — universe, every slot with its fill rule, and the settings. From the results panel:
- Record stats → — the full stats popup (design span only until you lock; the held-out span gets its own popup after)
- Metrics by period → — a visual: each quarter's return vs the benchmark, above a grid of which metric filled each slot at what weight; hover for exact values, or flip to Table view for the numbers
- How is this tested? — the plain-language methodology, opened at its Adaptive Strategy Builder section
Sweep (the Sweep Explorer) — the second tab explores a design space instead of one process: you set the structures, setting ranges and holdings you allow, the engine fills it with mechanically sampled draws, and the results render as a risk/return chart beside the random portfolios drawn from the same universe, with no ranking by return. Every dot's CAGR, drawdown and Sharpe compound the whole design span; a quarter the process stood aside counts as cash at 0% while the benchmark keeps compounding, so a dot and its full record say the same number. The rail's filters hide candidates by deepest drawdown, by holdings count and by the share of quarters traded (Traded at least…, for when you want candidates that were invested most of the time); the Distribution view draws only the records the filters leave visible, and a hidden record stays counted, never deleted. The universe — sectors, ranges and metric filters — is fixed for the whole sweep, so every draw and the random portfolios share it. Under the holdings range, Stock selection can be opened to several peer groups (whole market, sector peers, sector + size peers), each draw taking one of the checked ones; the Amount per stock is fixed for the whole sweep, so two sweeps with the same seed hold identical picks and differ only in the split. Pin a dot to read it, then Open full record computes that candidate's complete record (seconds), saves it tagged with the size of the field it was picked from, and opens it on the Records tab. Four views share the page: Map, List, Distribution and Persistence. Distribution shows what the whole sweep produced against random picking: the records and random portfolios of the same holdings counts over the same quarters as two histograms on one axis, with the records' median, the random median and the sweep's benchmark marked, for CAGR, max drawdown, volatility or Sharpe; the middle is the lift and the width is the range any one record landed in. Its Records picker draws all records, the records above the luck line, or the top X% by backtest CAGR; its Span picker covers the design span and, once the sweep is revealed, the whole series and the sealed two years alone, where the top-X% choice shows what picking by backtest got on quarters no record was designed on. Below Dots when fewer than N records the group is drawn as one dot per record instead of bars. Four tiles carry the middle, the share of records on the better side of the random median, the share that beat the benchmark, and the width. Persistence is where you name one or more cut dates and see, for each, whether the records' rank on CAGR, max drawdown, volatility, Sharpe and their standing against random portfolios before the cut carried over to after it: a table with one row per cut, one sentence for the selected cut, and a before/after scatter with the least-squares line through its dots, a Ranks instead of values checkbox (on ranks the line's slope is the rank correlation itself, and no outlier stretches the axes), Zoom (drag a rectangle over the part you want) and Reset axes, with every explanation in the tooltips. The View picker switches to Windows of N quarters: consecutive blocks that do not overlap, one row per adjacent pair of blocks and a pooled row over every pair. Export… saves the sweep as spreadsheets with a README. Reveal the last two years…, under the rail's honesty layer, unseals every record's last two years for the Persistence view and the export, permanently and dated, at the cost of any holdout verdict for candidates from that sweep.
Records — the third tab is the one home for everything the Builder has produced: every run and every sweep, filtered by kind or state, sorted by date or name only. Each card has Export…, and Export shown… in the toolbar writes everything the chips and search leave visible into one file. A sweep card says revealed
- Lock & Reveal… — while you design, the chart shows only the design span; the most recent ~2 years stay sealed. Locking is permanent: the held-out span is computed once, drawn past the LOCKED marker, and stamped on the process. Only a locked process can be adopted. A record marked selected after the reveal offers Lock (holdout already visible)… instead: locking still stamps the process and is still the gate to adoption, and the held-out span is shown as a stated fact, not a verdict.
- Adopt This Process… — shows the exact rules it will write (derived on today's data, next to the record's design-end rules) before anything is written, then asks which sleeve should run it and lands you in the Strategy Manager. Keep in Library Only skips the sleeve: the strategy lives in the Library's Adaptive Strategies tab, with Add to Strategy Manager offered on the record and on its Library card whenever you want it to run.
- Deployed — the strip names the sleeve running the strategy, with Open in Strategy Manager as the button.
Below the strip: the record chart, the stat tiles described above, the integrity line, the full process echoed back, and the record actions — Record stats →, Metrics by period →, Full history in Backtester →, Edit This Process (loads it back into the designer; editing a locked process creates a new, unlocked process), Rename…, and Delete (with confirmation). Records are replayed from the saved series, never recomputed.
Full history in Backtester → opens the record's replay: its saved quarterly picks priced day by day with the Backtester's standard trading costs, so you can read the equity curve between quarters, the drawdown, monthly returns, allocation and holdings for the process you just ran — and compare two design iterations side by side there. The replay is written automatically in the background when a record is saved (the link reads Preparing full history… for the second or so it takes) and extended with the held-out quarters when you lock. Until then it covers the design span only; the sealed span is never priced early. The stamped record on this page stays the evidence — the replay's returns sit slightly below the stat tiles by the trading costs.
At every rebalance an adopted process re-derives its rules against current data; a derivation that differs from the rules you last accepted becomes a pending proposal you review — accept or decline — in the Strategy Manager (see Adaptive Strategy Rules Proposals). Rebalances always trade the accepted rules, the preview shows the rules in force, and you approve every trade list before anything is placed.
5. Backtester¶
The Backtester (sidebar: Backtester) lets you simulate how a strategy would have performed over historical data — any strategy in the catalog, over any date range. Run full backtests, analyze results with detailed charts and metrics, and compare strategies side by side. ETF trackers also show their cached results inline on their Library cards, with links that open the full report here.
Layout¶
- Launcher panel (top, collapsible) — configure and run new backtests
- Results sidebar (left) — scrollable list of saved backtest results with key metrics
- Detail panel (right) — charts, metrics, and analysis tabs for the selected backtest
Launcher Panel¶
Configure a backtest run with these controls:
| Parameter | Description | Default |
|---|---|---|
| Strategy | Searchable dropdown of every strategy in the catalog: your scoring strategies, adaptive strategies, fixed-allocation baskets (saved and deployed), and the ETF trackers | — |
| Start / End | Date range for the simulation | 10 years ago – today |
| Rebalance | Days between portfolio re-evaluations (1–365) | 90, or a deployed fixed-allocation strategy's own cadence |
| Lookback | Quarters of historical data used for scoring (1–40). Greyed out for fixed-allocation strategies, which score nothing | 20 (5 years) |
| Capital | Starting portfolio value | $10,000 |
| RFR | Risk-free rate for Sharpe/Sortino calculations | 0.045 (4.5%) |
| Commission | Charged for every stock bought or sold at a rebalance | $1.00 |
| Slippage | Charged on the value of every stock bought or sold at a rebalance | 0.10% |
For a scoring strategy, a trade is a stock entering or leaving the portfolio; a stock that stays is not charged when it is resized back to its target amount. Under Amount per stock, each traded name pays slippage on its own position size: a buy at its share this period, a sell at the share it had last period. For a fixed-allocation basket, every holding pays the commission at each rebalance, and slippage applies to the amount traded to bring the weights back to target. Set both fields to zero to see a result before costs. Walk-forward records are computed before costs; their replays (below) carry these costs. Do backtests include trading costs? has a worked example.
Click Run Backtest to start. A progress bar and live log show period-by-period progress with an ETA. Click Cancel to abort a running backtest.
Adaptive strategies can be backtested here too, but a banner is displayed explaining the caveat: the backtest replays the strategy's current rules, which were derived from data through today, so the result is in-sample. An adaptive process's evidence is its walk-forward record in the Adaptive Strategy Builder.
That record has its own card here as well: every walk-forward record's replay — the record's saved quarterly picks priced day by day with the standard costs — appears under My Backtests, grouped by the record's name with the variant label Walk-forward replay; a one-line note is displayed under the chart saying what it is. Replays are written automatically by the Adaptive Builder (never from this launcher), cover the design span until the record is locked, and can be deleted here but not renamed or duplicated; the record page writes a fresh one on its next visit if the file is gone.
A fixed-allocation basket can only be backtested when the data pack has prices for every ticker in it. If one is missing, the run stops and names the ticker; it is never quietly dropped with the rest of the basket re-weighted.
Results Sidebar¶
Each saved backtest appears as a card showing the strategy name and four metric pills: CAGR, Alpha (α), Sharpe (SR), and Volatility (σ). Use the sort dropdown (Name, CAGR, Alpha, Sharpe) and filter pills (All, ETFs, Mine) to find results quickly.
- Add to Strategy Manager (+) — on ETF tracker results, opens the same Add to Strategy Manager dialog as the ETF's Library card: name the sleeve, set its allocation, and the tracker becomes a new sleeve
- Compare — select 2–5 backtests to overlay on charts and view metrics side by side
- Export — saves the selected backtest as spreadsheets: its settings and every metric on one row, one row per period, and a README naming every column (the daily curves stay in the app)
- Delete — remove selected backtest results
Charts & Metrics¶
Equity curve (top) — cumulative return of the strategy vs. SPY benchmark. A timeframe selector (30D, 90D, 6M, 1Y, 3Y, 5Y, 10Y, All) re-slices the view. For any other span, pick a start and end date next to Custom and press Go; the date pickers open on the selected run's first and last day. The metrics grid, the detail charts and the sidebar cards follow whichever window is active, and Reset returns to the last timeframe button. Click legend entries to toggle lines.
Every strategy type is drawn at every trading day. A scoring strategy holds its picks at the amounts its Amount per stock setting gives them (equal amounts unless set) from one rebalance to the next, so the curve shows what the portfolio was actually worth between rebalances, not just at the rebalance marks; trades and costs still land only on the rebalance schedule. The Filtered Universe line (the equal-weight average of every stock that passed the strategy's filters) is drawn on the same daily basis, so a scoring strategy, an ETF tracker and a basket all compare like for like.
Metrics grid — 24 statistics organized in six sections:
| Section | Metrics |
|---|---|
| Returns | CAGR, SPY CAGR, Total Return, SPY Total Return |
| Risk-Adjusted | Sharpe, Sortino, Calmar, Profit Factor |
| Risk & Volatility | Max Drawdown, Ann. Volatility, Alpha, Beta |
| Period Performance | Win Rate, Best Period, Worst Period, Avg Stocks/Period |
| Universe & Capacity | Avg Mkt Cap, Min Mkt Cap, Est. Capacity, Capacity Used |
| Trading Costs | Total Commissions, Total Slippage, Friction Drag, Avg Turnover |
Values are color-coded green (good) or red (bad) where applicable.
Max Drawdown and Calmar scan the daily curve for every strategy type, so a trough between two rebalances counts. The return-distribution statistics (Sharpe, Sortino, volatility, alpha, beta, win rate, profit factor, best and worst period) are computed on the rebalance grid — the periods the strategy actually held positions — so on a 30D or 90D window they show a dash when fewer than two rebalances fall inside it, while return, CAGR and drawdown still read from the daily curve.
Detail tabs below the metrics grid:
| Tab | What it shows |
|---|---|
| Monthly Returns | Heatmap grid (months × years) color-coded from red (losses) to green (gains); each month's return comes from the daily curve, and the Show dropdown switches to excess return over SPY, the sector ETF or the Filtered Universe |
| Allocation | Pie of the strategy's time-averaged composition across all rebalance periods, with Sector / Industry / Market-Cap lenses |
| Drawdown | "Underwater" chart of peak-to-trough losses on the daily curve, with the max drawdown labeled |
| Rolling Metrics | 1-year rolling Sharpe, Beta, and Alpha overlaid on one chart |
| Holdings Analysis | Horizontal bar chart of the top 15 most frequently selected stocks |
| Selection | Universe size and mean score over time (not applicable to fixed-allocation strategies) |
Compare Mode¶
Click Compare, then check 2–5 backtest cards. The equity chart overlays all selected strategies with SPY, and the metrics grid switches to a side-by-side comparison table. Click Compare again to exit.
Tips¶
- Every backtest is saved automatically — experiment freely and compare runs later.
- Use the timeframe selector on the equity chart to zoom into specific market periods (e.g., COVID drawdown, 2022 rate hikes).
- The Capacity metrics help you judge whether a strategy is realistic at your portfolio size — high capacity usage means the strategy may not scale.
- ETF trackers ship with cached full-history results — open one to see what a finished report looks like before running your own.
Company Research¶
The Company Research section is for single-company work: a deep fundamental profile of any ticker, and a real-time screen across the whole universe.
6. Company Analysis¶
Company Analysis gives you a deep fundamental profile of any individual stock — key metrics at a glance, interactive trend charts, and earnings data.
Layout¶
- Search bar — enter any ticker
- Company header — name, sector, industry, market cap
- Key metrics cards — 16+ financial statistics
- Earnings card — recent and upcoming earnings
- News card — coming soon
- Trend charts — 8 default charts plus custom chart builder
- Data source line — once a company is displayed, the bottom of the page reads "Market data by Financial Modeling Prep": the profile, prices and statement values on this page come from the database licensed from Financial Modeling Prep
Search Bar¶
Type a ticker into the search field and click Analyze, or pick a ticker from a strategy's holdings using the dropdown selectors. The entire page updates to show that company's data.
Company Header¶
Displays the company name in large text with metadata below: ticker, sector, industry, country, and market cap. A brief company description is shown with a "more" toggle to expand the full text.
Key Metrics Cards¶
A grid of 16+ financial statistics covering:
- Valuation — P/E, P/B, P/S, EV/EBITDA, FCF Yield, Earnings Yield
- Profitability — ROE, ROIC, gross margin, operating margin, net margin
- Financial health — Altman Z-Score, debt-to-equity, interest coverage, current ratio
Each metric is formatted appropriately (percentages, ratios, dollar values) with the most recent values highlighted.
Earnings Card¶
Shows recent earnings results (EPS, revenue, beat/miss status) and the next upcoming earnings date. Expand for a historical earnings table.
News Card¶
Coming soon. The card is in place and reads "News feed coming soon" — company headlines are planned for a future release.
Trend Charts¶
Eight default interactive charts are displayed:
- Price history with 50-day and 10-day moving averages
- Revenue & earnings over time
- Profit margins (gross, operating, net)
- Cash flow (operating, free, capex)
- Profitability (ROE, ROIC)
- Balance sheet health (debt ratios, Z-Score)
- Valuation multiples (P/E, P/B, EV/EBITDA)
- Per-share metrics (EPS, book value, revenue per share)
Custom Chart Editor¶
Want to see a metric combination that isn't in the defaults? Click + Add Custom Chart to create a custom chart:
- Left Y-axis metric — pick from the full metric catalogue
- Right Y-axis metric — overlay a second series on a separate axis
- Time range — select the history window
Custom charts can be reordered (move up/down), edited, or deleted. A Reset to Defaults button restores the eight defaults.
Tips¶
- You can jump to Company Analysis directly from the Company Screener or Holdings tab by clicking on a ticker, or from a strategy's View list in the Strategy Manager.
- The custom chart editor with dual Y-axes is useful for spotting relationships — for example, overlay FCF Yield against price to see if the stock gets cheaper when cash flow improves.
7. Company Screener¶
The Screener lets you filter the entire universe of ~5,000 US stocks in real time. Define conditions, see which companies pass, and click through to Company Analysis for a deeper look.
Layout¶
- Filter panel (collapsible) — categorical and metric-based filters
- Results table — companies that pass all filters
- Data source line — below the table, "Market data by Financial Modeling Prep": the company names, sectors and industries in the table come from the database licensed from Financial Modeling Prep
Filter Panel¶
The panel has two types of filters:
Categorical filters — dropdown selectors with checkboxes for:
- Sector (e.g., Technology, Healthcare, Energy)
- Industry
- Country
- Exchange
Metric filters — add cards that define numeric conditions:
- Choose a metric from the full catalogue (120+ options)
- Set an operator (>, <, >=, <=, ==, !=) and a value
- Example: "P/E Ratio < 20" or "ROE > 15%"
Click + Add Filter to add more metric conditions. Use Apply Filters to update results. Reset All clears everything and shows the full universe.
A count label at the top ("X of Y companies") updates as you filter.
Results Table¶
Companies passing all filters appear in a sortable table. Fixed columns include:
- Ticker, Name, Sector, Industry
Additional metric columns are configurable — click Configure Columns to open a dialog where you can pick which metrics appear, grouped by category (Valuation, Growth, Profitability, etc.) with select-all/deselect-all per group.
Double-click any row to navigate directly to Company Analysis for that ticker.
Tips¶
- The Screener uses the same metrics matrix as the Strategy Lab tools. If you see "No metrics matrix loaded," open Research and build or load one first.
- Use the column configurator to add the metrics you care about — the default view only shows a few, but you can display any of the 150+ metrics as columns.
- Combine categorical and metric filters to narrow quickly. For example: Technology sector + ROE > 15% + Debt-to-Equity < 1.0 gives you financially strong tech companies.
Portfolio¶
The Portfolio section is where your money lives — what you hold, what your strategies are doing, and how it's all performing. The section header holds the portfolio switcher, the active portfolio's money-type label, and the Manage Portfolios link.
8. Dashboard¶
The Dashboard is your portfolio's home screen — a single-page summary of where your money stands and how it's performing.
Layout¶
- Summary metrics row across the top
- Risk metrics table below the summary
- Monthly returns heatmap showing the last five years
- Portfolio performance chart with benchmark overlay
- Recent performance table covering the last 30 trading days
Summary Metrics¶
A horizontal row of key figures, each color-coded green (positive) or red (negative):
| Metric | What It Shows |
|---|---|
| NAV | Current portfolio net asset value |
| HWM NAV | High-water mark in today's dollars — the NAV you would have at your best-ever return level with your current capital (deposits and withdrawals neutralized) |
| Daily PnL | Dollar change today |
| Daily Ret | Percentage change today |
| PnL YTD | Year-to-date profit and loss |
| Realized YTD | Total realized gains/losses this year |
| Net Exp YTD | Net expenses (commissions, fees, interest) this year |
| CURR DD | Current drawdown — how far your time-weighted return sits below its all-time high (a deposit or withdrawal never moves it) |
If margin trading is enabled, two additional metrics appear: Leverage and Margin Int YTD.
Returns Card¶
A dedicated returns card displays both return methodologies side by side:
| Period | TWR | MWR |
|---|---|---|
| MTD | ✓ | ✓ |
| QTD | ✓ | ✓ |
| YTD | ✓ | ✓ |
| 1Y | ✓ | ✓ |
| 3Y Ann. | ✓ | ✓ |
| 5Y Ann. | ✓ | ✓ |
| 10Y Ann. | ✓ | ✓ |
- TWR (Time-Weighted Return) — measures portfolio performance independent of cash flows. Useful for evaluating your strategy's skill.
- MWR (Money-Weighted Return / IRR) — measures your actual investor return, accounting for the timing and size of deposits and withdrawals. Useful for understanding what you personally earned.
If you haven't made any deposits or withdrawals, TWR and MWR will be identical. The more your cash flows affect timing, the more they'll diverge.
Risk Metrics¶
A two-row table comparing Lifetime and YTD risk statistics:
Volatility, Sharpe, Sortino, Calmar, Max Drawdown, Beta, Alpha, Correlation, Win Rate, Best Day, Worst Day
Annualized return is the compound annual growth rate of the daily-return chain. Sharpe and Sortino use a fixed 4% risk-free rate; Sortino's downside deviation counts every day's shortfall below it. Alpha is Jensen's alpha against SPY. Max Drawdown is measured on the flow-adjusted curve, so deposits and withdrawals never count. The quarterly and annual PDF reports use the same conventions. The YTD row shows dashes until the year has at least six sessions.
Hover over any column header for a tooltip explaining how the metric is calculated.
Monthly Returns Heatmap¶
A color-coded grid covering the last five years. Each cell shows one month's return — green for gains, red for losses, with intensity reflecting magnitude. Check the vs SPY toggle to switch the heatmap from absolute returns to relative performance against the S&P 500.
Portfolio Performance Chart¶
An interactive line chart showing your portfolio's cumulative return alongside benchmark indices (SPY, QQQ, DIA). All lines are normalized to a common starting point so you can compare percentage gains directly.
Controls:
- Range selector — 7D, 30D, 90D, 6M, YTD, 1Y, 3Y, 5Y, or Lifetime
- Legend — click any series name to show/hide it
- Hover — move your cursor over the chart to see exact values at any date
Recent Performance Table¶
The last 30 trading days in tabular form. Columns include daily, 7-, 30- and 90-calendar-day, and YTD returns (both dollar and percentage), plus high-water mark NAV, drawdown, economic realized gains (before wash-sale adjustments) broken out by short-term and long-term, and commissions. Hover a column header for its definition. All values are color-coded.
Tips¶
- The Dashboard needs at least one day of portfolio data to display anything. Data is synced automatically on startup.
- The "vs SPY" toggle on the heatmap is useful for distinguishing skill from market conditions — a green month during a red market is more meaningful than a green month when everything is up.
9. Strategy Manager¶
The Strategy Manager is the central hub for configuring what your portfolio actually does — which strategies are active, how much capital each gets, and how often they rebalance.
Layout¶
- Allocation bar — visual breakdown of capital across strategies
- Strategy cards — one card per strategy with controls and status
Allocation Bar¶
A horizontal stacked bar at the top showing how your NAV is divided among active strategies, largest allocation first — each strategy's segment color matches the tint on its card below. The bar updates live as you change allocations. If margin is enabled and you exceed your leverage cap, the bar turns red as a warning.
Strategy Cards¶
Each managed strategy gets its own card showing:
- Strategy name and type badge (Equity Scoring or Fixed Allocation)
- Active toggle — switch a strategy on or off without deleting it
- Allocation percentage — how much of your portfolio this strategy manages
- Rebalance schedule — daily, weekly, every 4 weeks, or every 12 weeks (week-based options pick a day of the week)
- Rebalance and Schedule… buttons (see Manual Rebalance and Scheduling a Rebalance)
- View opens the strategy's current stock list (or its target weights). A scoring strategy's list has a Target column: each name's share of the sleeve's money at the next rebalance, equal amounts unless the strategy's Amount per stock setting tilts it by company size (the rebalance preview shows the same share on every buy). Every row has a button that opens that company in Company Analysis; in a scoring strategy's list, an Exclude checkbox adds the stock to the strategy's Excluded Tickers (or removes it) immediately, and the row is crossed out until the next rebalance rebuilds the list without it. A stock the strategy already holds is kept, not sold.
- Edit button, plus a single Archive-or-Delete button: strategies that have traded show Archive (their history must be preserved), while never-traded strategies show Delete. A Copy button appears if you have more than one portfolio, for copying the strategy's configuration across.
Creating a New Strategy¶
Click New Strategy to choose a type:
- Equity Scoring — define criteria that score stocks and automatically select a portfolio
- Fixed Allocation — set target weights for specific tickers and rebalance to maintain them
A third strategy — Discretionary — exists automatically and cannot be deleted. It tracks trades made directly in your brokerage account outside of QuantAscent (so they don't show up as "Unknown"), and its allocation updates automatically based on your actual holdings. It doesn't get its own card (there's nothing to configure), but its share appears in the allocation bar.
Editing an Equity Scoring Strategy¶
The editor lets you configure:
- Strategy name
- Criterion cards — each one defines a metric, a direction and a weight
- Rebalance frequency and schedule
- Filters (sector, market cap, etc.)
- Excluded Tickers — a per-strategy manual list of symbols to keep out of this strategy's ranked list (separate from the cross-portfolio global list in Settings). The Exclude checkbox in the strategy's View list edits the same list.
Editing a Fixed Allocation Strategy¶
The editor shows:
- Strategy name
- A holdings table with ticker, target weight, and current weight columns
- Add/remove holdings
- Rebalance frequency
Adaptive Strategy Rules Proposals¶
A sleeve running an adaptive strategy re-derives its rules from current data on the process's cadence. A new derivation that differs from the rules you last accepted never takes effect silently — it waits as a proposal:
- The strategy's card shows a Rules change pending pill. Click it to open the review dialog, which shows the rules in force (accepted, with their data-through date) beside the proposed rules (with their derivation date).
- Accept New Rules makes the proposal the trading rules; declining keeps the current rules. Nothing changes until you choose.
- Rebalances always trade the accepted rules — a pending proposal is never traded, and the rebalance preview notes when a rules change is awaiting your review.
- If the process derives again before you decide, the newer derivation supersedes the older proposal.
Manual Rebalance¶
Each strategy card includes a Rebalance button. Rebalancing is a single action — for scoring (Equity Scoring) strategies it regenerates the strategy's ranked stock list first, then trades it. There is no separate "Generate" step. (Fixed Allocation strategies have static targets, so there is nothing to regenerate.)
- Click Rebalance on any strategy card
- For an Equity Scoring strategy, the stock list is regenerated from current data — this takes a moment and needs no broker connection
- A preview dialog shows the proposed trades — exit sells, trim sells, and buys — with estimated quantities, prices, and values
- Review the summary (total sells, total buys, net) and click Execute Rebalance to proceed, or Cancel to abort
- Execution runs in a background window you can minimize — keep using the rest of the app while it works. The window shows each order's live status (Working → Filled), the order Type actually placed (see below), and its actual fill price as it happens, and stays open with a per-order summary when complete so you can review exactly what executed (close it yourself when done). Holdings and the Trade Log refresh automatically.
Rebalance All Active (in the bottom toolbar) rebalances every active strategy — it shows one combined preview, then executes each strategy as its own rebalance in sequence (one at a time, net-sellers first so the cash they free funds the buyers), rather than as a single netted batch. You watch them go one by one in the same window.
If Interactive Brokers isn't connected, trades can't be placed — so Rebalance instead offers to Connect IBKR, Regenerate List Only (refresh your picks without trading — handy if you use QuantAscent only for research), or Cancel.
You need IB Gateway (or TWS) running for live rebalances. Prices shown in the preview are estimates — orders fill reliably, and buys are re-sized to the cash your sells actually freed.
Order type follows your Order Mode setting. The execution window's Type column shows what was actually placed. With Settings > Trading > Order Mode set to Market, rebalances use true market orders during regular trading hours and automatically fall back to a marketable limit order (lifting the current ask for buys, hitting the bid for sells) outside regular hours. With Limit modes, orders are priced at the live market the moment they're placed.
How long an unfilled order keeps working before it cancels is set by Settings > Trading > Order Deadline: a fixed timeout you choose, or until the end of the trading day (GTD).
Excluded tickers. If a rebalance turns up a symbol IBKR can't trade, the Invalid IBKR Tickers Detected prompt removes it from this rebalance and offers to Exclude Permanently — adding it to the cross-portfolio Excluded Tickers list (in Settings) so it's skipped on every strategy from then on, with a replacement surfaced on the next list generation. Choose Skip for Now to leave the global list unchanged. You can still keep per-strategy manual exclusions in a strategy's editor.
Scheduling a Rebalance¶
You don't have to rebalance the instant you decide to. Click Schedule… on a strategy card to pick a day and time — later today or on the next trading day — for that strategy's rebalance to fire. The horizon skips holidays (on a Friday you can schedule Monday, or Tuesday if Monday is a holiday), and the time defaults to 10:00 AM ET, clear of the volatile first minutes after the open.
- You approve the same frozen rebalance preview you'd approve for an immediate rebalance — the plan you approve is exactly what runs at the scheduled time. Nothing is re-generated later.
- Scheduled items appear in the Upcoming Schedule panel, each tagged with a SCHED chip and showing the day and time it will run.
- Each scheduled item has Reschedule and Cancel actions.
A scheduled rebalance is a one-shot, explicitly authorized trade — it will not regenerate or second-guess the plan you approved, and it's the only way a trade runs unattended. Rebalance All Active can also be scheduled as a batch.
Requires the app and your IB Gateway (or TWS) to be running at the scheduled time. If either is closed when the schedule fires, the trade won't be placed.
Scheduling When the Market Is Closed¶
If you click Rebalance (or Rebalance All Active) while the market is closed, QuantAscent offers to queue the work for the next session instead of running it against a closed market. The preview dialog adds a Schedule Instead… option (and Schedule All Instead… for the batch) that places the approved plan in the Upcoming Schedule for the next market open. Manual Holdings orders behave the same way — they queue to the next open rather than being blocked (see the Holdings tab).
Renaming, Archiving, and Deleting Strategies¶
- Rename — open a strategy's editor and edit the Name field (prefilled with the current name) to rename it.
- Archive — click Archive on a strategy card to retire a strategy you've finished with. Archived strategies move into a collapsible Archived section at the bottom of the tab and are excluded from the Strategy Performance chart and table and from the strategy pickers elsewhere in the app. Each archived strategy has:
- View History — a lifetime summary: active period, lifetime return, realized P&L, and trade counts (buys and sells).
- Unarchive — bring it back into your active strategies.
- Delete — only strategies that have never traded can be deleted, so the card shows Delete only for a strategy with no trade history. Once a strategy has traded, deleting it would orphan those trades, so the button becomes Archive instead (its history stays intact).
Tips¶
- Archiving (rather than deleting) preserves a traded strategy's full history; deactivating (the Active toggle) keeps a strategy in your active list but pauses its trading.
- The allocation bar is the fastest way to check whether your strategies are using the amount of capital you intend.
10. Holdings¶
The Holdings tab shows every open position in your portfolio with real-time data from Interactive Brokers, and lets you place orders directly.
Layout¶
- Holdings summary card — aggregate account and performance metrics
- Holdings table — all open positions with detailed columns and a frozen TOTAL row
Holdings Summary¶
A summary card at the top showing:
| Metric | Description |
|---|---|
| NAV % | Share of net asset value currently invested |
| Invested | Total market value of open positions |
| Total NAV | Account net asset value |
| Total PnL | Unrealized dollar P&L (color-coded) |
| Total Return | Percentage gain or loss (color-coded) |
| Daily PnL / Daily Return | Today's dollar and percentage change |
| vs SPY / vs QQQ / vs DIA | Today's performance relative to the major index ETFs |
If margin trading is enabled, Buying Pwr, Leverage, and Excess Liq appear as well.
Holdings Table¶
The main table lists every position with columns:
- Ticker — the symbol
- Strategy — which strategy owns this position
- Qty — shares held
- %NAV — the position's share of net asset value
- Avg Price — average cost basis per share
- Days Held — how long the position has been open
- Mkt Value — quantity times current price
- Daily Ret / Daily PnL — today's percentage and dollar change (green/red)
- Total PnL / Total Ret — unrealized dollar and percentage P&L (green/red)
Click any column header to sort (the TOTAL row stays frozen at the bottom). Each row also has two quick-action buttons: ▤ opens Company Analysis for the ticker and ↗ opens its price chart.
Order Placement¶
Select a holding and use the order panel to place trades directly through IB Gateway:
- Buy or Sell toggle
- Quantity input
- Strategy assignment — tag the trade to a specific strategy
- Orders execute through your connected IBKR account and run in the background — an Orders window tracks each order's live status and fill price, you can place several at once and keep using the app while they work, and each row has a Cancel button to stop a still-working order. Unfilled orders follow your Order Deadline setting (timeout or end of day).
- Placing an order while the market is closed doesn't block you — QuantAscent offers to Queue Order at IBKR so it executes at the next market open (it explains that the opening price can differ from the last quote, and that the order auto-cancels shortly after the open if still unfilled).
Without TWS or IB Gateway¶
When TWS or IB Gateway is not running, the page shows your positions as of the last statement day on record instead of blanks. Prices are the marks from your most recent IBKR statement (the same daily download that feeds the Dashboard), and the nightly price pack supplies any position the statement does not carry. Total NAV and the Daily PnL and Daily Return tiles come from the portfolio log the Dashboard reads, so the two pages agree. A line above the tiles states the day, for example "Prices as of the Thu Oct 29 close", and while a database is installed it ends with "Market data by Financial Modeling Prep", the supplier of the price pack. Every number on the page refers to that day: the Daily columns are that day's move, and the vs SPY / vs QQQ / vs DIA tiles compare it with that day's index moves. A position neither source can price keeps "--" and stays out of the pie chart. Order placement and the price chart wait for the live connection; once TWS or IB Gateway connects, the page reloads with live prices and the line disappears.
When IBKR is slow to answer¶
The page fills in as IBKR answers. Total NAV and your positions appear first, priced from TWS's own marks; the Daily columns and the vs SPY / vs QQQ / vs DIA tiles read "--" until the previous closes arrive, usually a second or two later. A "--" there means the figure is not known yet, never that the position was flat.
If something does not arrive, a line above the tiles says what is missing, with a Retry button beside it:
- "Previous closes have not arrived from IBKR" — NAV, positions and prices are live; only the Daily columns are waiting.
- "TWS / IB Gateway has not answered" — TWS is running but did not send the account. The page shows the last statement day on record (as it does without TWS) until it does.
The page asks IBKR again by itself, once after a few seconds and then every minute, and Retry asks at once. The line and the button stay until a load completes. A load that is still running after 15 seconds shows Cancel & Retry, which stops it and starts a new one. If "has not answered" continues, check that TWS or IB Gateway is logged in.
Tips¶
- The strategy column tells you which strategy is responsible for each position. If you place manual trades, they show up as unassigned until you tag them.
- Positions update automatically after trades execute — no manual refresh needed.
11. Strategy Performance¶
This tab tracks how each of your strategies is performing independently, so you can see which ones are earning their allocation.
Layout¶
- Controls bar — date range, toggles, and filters
- Cumulative return chart — multi-strategy overlay with benchmarks
- Performance summary table — returns across multiple time windows
- Risk metrics table — risk statistics for each strategy and each benchmark over the selected window
Controls¶
A single horizontal bar with:
- Window selector — 7D, 30D, 90D, 6M, YTD, 1Y, 3Y, 5Y, or Lifetime
- All / None buttons — quickly show or hide all strategy lines
- Weighted checkbox — toggle between allocation-weighted returns and raw strategy performance
- Custom date range — enable a custom start/end date with calendar pickers
- Defaults… — open the Chart Defaults dialog to configure persistent default settings (see below)
Cumulative Return Chart¶
An interactive line chart where each strategy gets its own colored line. Benchmark indices (SPY, QQQ, DIA, IWM) appear as dashed lines for comparison. All series are normalized to a common starting point.
When Weighted mode is on, strategy returns are scaled by their allocation percentage, and the chart title updates to reflect this. The legend shows each strategy's allocation weight.
Click any series name in the legend to show or hide it. Hover for exact values at any date.
Performance Summary Table¶
A table showing returns for each strategy and benchmark across standard time windows:
1D, 30D, 90D, 6M, YTD, 1Y, 3Y, 5Y, and Lifetime — all color-coded green or red. Columns are automatically hidden if your data doesn't span that period yet. Hover a series name to see it in full.
Risk Metrics Table¶
Risk statistics over the selected date range, one row per strategy followed by one row per visible benchmark, so a strategy's Sharpe or max drawdown sits beside SPY's over the same sessions:
Volatility, Sharpe, Sortino, Calmar, Max Drawdown, Beta, Alpha, Correlation (to SPY), Win Rate, Best Day, Worst Day
Every row uses the same formulas and the same fixed risk-free rate as the Dashboard's Risk Metrics section. A strategy's row starts on its first active day when that is later than the window start, so sessions before the strategy existed never count. Benchmark rows cover the whole window. Beta, Alpha and Correlation are measured against SPY, so SPY's own row reads 1.00, 0.00% and 1.00. Hover a series name for its full name and the sessions its row covers. Hover a column heading or a value for the metric's definition, the same text the Dashboard shows. The Total row is not listed here; portfolio-level risk is on the Dashboard.
Chart Defaults Dialog¶
Click Defaults… to open the Chart Defaults dialog and configure persistent preferences for this chart:
- Default time window — choose which range the chart opens to (7D, 30D, 90D, 6M, YTD, 1Y, 3Y, 5Y, or Lifetime)
- Series visibility — check or uncheck individual strategies and benchmarks to control which lines are shown by default when the chart loads
These settings are saved per portfolio and persist between sessions. Use the Select All / Deselect All buttons to quickly configure each group.
Tips¶
- Compare the Weighted view against the raw view to see how allocation sizing affects your results. A strategy with great raw returns but a tiny allocation may not be moving the needle.
- Use the custom date range to isolate specific market periods (e.g., a downturn) and see how each strategy held up.
12. Trade Log¶
The Trade Log is a complete record of every trade your portfolio has executed, organized for both performance review and tax reporting.
Layout¶
- Realized stats panel — today's and year-to-date realized gains
- Closed trades tree — expandable view of all completed trades
- Open positions table — unfilled lots still held
Realized Stats Panel¶
Three highlighted cards at the top:
- Today's Activity — today's realized P&L, closed lots, and commissions
- Realized YTD — year-to-date totals: Economic (with ST/LT breakdown), Wash Adj, and Tax, color-coded green or red
- Open Positions — total cost basis, position count, and strategy count for what's still open
Closed Trades Tree¶
The main view is an expandable tree. Each parent row represents a sale and shows:
Sale Date, Buy Date, Symbol, Contract ID, Qty, Sell Price, Type (short-term or long-term), Strategy, Profit, ST Gain, LT Gain, Return %
Profit values are color-coded green for gains, red for losses. Expand any sale to see the individual lot matches — which specific purchase lots were matched against the sale using FIFO (first-in, first-out) order:
- Lot purchase date
- Lot reference number
- Matched quantity
- Cost per share
- Long-term or short-term classification
Open Positions Table¶
A read-only table showing positions that haven't been closed yet, with columns: Buy Date, Symbol, Contract ID, Type, Strategy, Quantity, and Average Price.
Tips¶
- The ST/LT classification matters for taxes — long-term gains (held over one year) are taxed at a lower rate. The Trade Log tracks this automatically.
- Use the Account tab's report generator to export a Realized Gains Schedule or Wash Sale Schedule based on this data.
13. Account¶
The Account tab tracks the money flowing into and out of your portfolio — deposits, withdrawals, and how your investment gains compare to what you've contributed.
Layout¶
- Summary cards — four key figures
- Account balance chart — portfolio value over time with cash flow markers
- Transaction history table — every deposit and withdrawal
- Reports section — generate and manage portfolio reports
Summary Cards¶
Four large-format cards across the top:
| Card | Description | Color |
|---|---|---|
| Total Deposited | Sum of all deposits | Green |
| Total Withdrawn | Sum of all withdrawals | Red |
| Net Contributions | Deposits minus withdrawals | Neutral |
| Investment Gain | Current value minus net contributions | Green/Red |
Account Balance Chart¶
A line chart of your portfolio value over time. Deposits appear as green upward triangles and withdrawals as red downward triangles, each with a dotted vertical line marking the date. Hover over any marker to see the transaction amount and your account balance at that point.
Range selector: 30D, 90D, 6M, YTD, 1Y, or Lifetime.
Transaction History¶
A scrollable table listing every deposit and withdrawal with date, type (color-coded), amount, and running account balance. Sortable by any column.
Reports¶
Generate portfolio reports from a dropdown of six types:
| Report Type | What It Covers |
|---|---|
| Quarterly Portfolio | Performance statement for any quarter — returns vs benchmarks, monthly returns, risk metrics |
| Annual Portfolio | Full-year review with quarterly breakdown and benchmarks |
| Broker Reconciliation | Positions and account value checked against your IBKR statement |
| Wash Sale Schedule | Wash sale replacement lots for tax purposes (PDF + Excel) |
| Realized Gains Schedule | Short-term and long-term realized gains (PDF + Excel) |
| Tax Year Summary | Tax-ready summary for your CPA (PDF + Excel) |
Each report type shows a matching period picker — quarter and year for quarterly reports and tax schedules, year for annual reports, or an as-of date for the Broker Reconciliation — so you can generate historic reports for any period your data covers (for example, Q4 of last year). Defaults are the last completed period.
Click Generate to create a report (runs in the background; the PDF opens automatically, and failures are reported in a dialog). The five most recent reports appear in a quick-access table below. Click View All to open the Generated Reports manager, where you can filter by type, sort, open a report or show it in its folder, select multiple files to delete (always with confirmation; a tax schedule's Excel companion is removed with its PDF), and bulk-delete reports older than a chosen age.
Tips¶
- The Investment Gain card is the clearest measure of whether your strategies are making money — it strips out the effect of deposits and withdrawals.
- Reports are saved as files in your data directory and persist between sessions.
Settings¶
Settings is where you configure QuantAscent's connection to IBKR, manage backups, and tune global preferences.
Layout¶
Settings is organized into five tabs across the top of the page. The first two — Account and Data — are global and apply to every portfolio. The last three — Connection, Trading, and Portfolio — are scoped to the currently active portfolio; a context bar above the cards reminds you which portfolio you're editing.
Settings save automatically as you change them — a brief "✓ Saved" confirmation flashes at the top of the page. There is no Save button.
Account Tab¶
Sign-In & Subscription — your QuantAscent sign-in status. The status badge next to your email reflects your access, for example Active (full access), Free trial, No subscription, Subscription expired, or Access revoked (contact support if that's unexpected).
| Setting | Description |
|---|---|
| Keep me signed in on this computer | Skip the sign-in dialog on subsequent app launches |
| Sign In / Sign Out | Start a session (if you launched in read-only mode) or end it and clear local credentials |
| Manage Account ↗ | Open the hosted account profile in your browser |
Getting Started — replay the guided onboarding tour that walks through each part of the app.
Appearance
| Setting | Description |
|---|---|
| Privacy Mode | Mask every dollar value in the UI with $•••• (account balances, deposits, P&L $, cost basis, market values, chart axes, etc.). Percentages, share counts, and tickers stay visible. Useful for screen recording or sharing tutorials without revealing account size. Takes effect immediately. Default: off. |
Data Tab¶
Strategy Library — select which metrics matrix the research tools use by default. Useful if you've built multiple matrix versions with different date ranges or parameters.
Backup
| Setting | Description |
|---|---|
| Backup Folder | Choose where backup files are stored (folder picker) — backups run automatically on the daily schedule |
Database
| Setting | Description |
|---|---|
| Check for Updates | Manually check whether a newer database version is available |
| Sync Now | Download and install the latest database |
Under the database version, the card lists the data feeds in use and, while a database is installed, the line "Market data by Financial Modeling Prep": the prices, company profiles and financial statements in the database are licensed from Financial Modeling Prep.
Software Updates — shows the installed app version and lets you check for app updates manually (updates are also checked automatically on every launch). If an update is released while the app is open, an Update required notice appears and data downloads pause until you quit and reopen the app.
Connection Tab (per portfolio)¶
IBKR Gateway
| Setting | Description |
|---|---|
| Account Mode | Select Live Trading (port 7496) or Paper Trading (port 7497) |
| IBKR Host | IP address of the machine running IB Gateway (default: 127.0.0.1) |
Flex Credentials
| Setting | Description |
|---|---|
| Flex Token | Your IBKR Flex Web Service token (see Setup Guide for how to get one) |
| Query ID | The numeric ID of your Flex Activity Query |
These are stored locally — never sent anywhere except to IBKR. Each portfolio keeps its own token and Query ID.
Trading Account
| Setting | Description |
|---|---|
| IBKR Account | The specific IBKR account number this portfolio's orders route to. Bind it manually if you trade more than one account, or let it auto-bind on first connect/sync. Before any trade, QuantAscent checks that the connected account matches — it warns you on a cross-account mismatch or a Live (Real Money) ↔ Paper (Fake Money) mismatch rather than misrouting the order. |
Trading Tab (per portfolio)¶
Execution
| Setting | Description |
|---|---|
| Order Mode | How orders execute: Limit (mid-price), Market (immediate), or Limit then Market (try limit first, fall back to market) |
| Order Deadline | How long an unfilled order keeps working: After timeout (cancel once the Order Timeout elapses) or End of day (GTD) (keep working until the market close, then cancel). Applies to manual orders and rebalances. |
| Order Timeout | How many seconds to wait for an unfilled order before cancelling it — used when Order Deadline is After timeout (the box hides when End of day is selected). Can be set up to a full trading day. |
| Min Trade $ | Minimum dollar value for a rebalance trade. Trades below this threshold are skipped to avoid commission drag on tiny orders (default: $50) |
| Margin Mode | Turn margin trading on or off |
| Max Leverage | Maximum leverage ratio (up to 4x). Applies only when IBKR reports a margin account; a cash account is sized at 1x |
| Broker Account | Which kind of account IBKR reports (margin, cash, or not connected), read from the live account figures. On a cash account the Max Leverage control is capped at 1x |
| Extended Hours | Allow orders to fill during pre-market (4:00 AM–9:30 AM ET) and after-hours (4:00–8:00 PM ET) sessions. Only limit orders can fill outside regular hours. Defaults to off. Live (Real Money) accounts only — IBKR doesn't fill or report extended-hours orders on paper (Fake Money) accounts, so the checkbox explains this and reverts if you try to enable it on a paper portfolio. |
Excluded Tickers
| Setting | Description |
|---|---|
| Excluded Tickers | A cross-portfolio list of symbols screening may surface but IBKR can't trade. Symbols here are excluded from every strategy's and portfolio's buy list, on top of any per-strategy manual exclusions. The list auto-fills when a rebalance hits an untradeable ticker and you choose Exclude Permanently; you can also edit it directly (comma- or space-separated) to add or remove symbols. |
Portfolio Tab (per portfolio)¶
Inception & Rebuild
| Setting | Description |
|---|---|
| Portfolio Start Date | The inception date of your portfolio, used as the default start for full data rebuilds |
| Rebuild | Wipe the portfolio, trade, and strategy logs and rebuild everything from your IBKR Flex statements. A timestamped backup is taken first. |
Tips¶
- Paper Trading mode (port 7497) is the safest way to test strategies with real market data but fake money. Switch to it here before experimenting with live trading.
- Backup settings are worth configuring early — your portfolio log and trade database are valuable and not stored anywhere else.
Manage Portfolios (Dialog)¶
Manage Portfolios is a dialog window opened from the link in the sidebar's Portfolio section. It lets you manage multiple portfolios — each with its own positions, trade history, strategies, and performance data.
Layout¶
- Portfolios table — list of all active portfolios
- Action buttons — Create Portfolio, Rename, Archive, Delete
- Archived section — a collapsible list of archived portfolios below the table
Portfolios Table¶
| Column | Description |
|---|---|
| Name | Portfolio display name |
| Type | Live (Real Money) (green) or Paper (Fake Money) (yellow) — determines which IBKR port is used |
| IBKR Account | The IBKR account number the portfolio is bound to, if any |
| Created | Date the portfolio was created |
| ID | Internal identifier |
Actions¶
- Create Portfolio — starts the guided portfolio-creation flow: choose the money type (Real Money (Live Trading) or Fake Money (Paper Trading)), set a name and optional description, then enter the portfolio's IBKR Flex credentials in the connection wizard that follows. QuantAscent pulls the portfolio's trading history immediately after. Each new portfolio gets its own isolated data directory.
- Rename — change a portfolio's display name
- Archive — hide a portfolio from the switcher while keeping all its data. Archived portfolios move to the Archived section below, where they can be restored anytime.
- Delete — remove a portfolio and its data. Only a portfolio that has never traded can be deleted. If a portfolio has any trade history, QuantAscent declines (deleting it would orphan its records) and offers to Archive it instead.
To switch between portfolios, use the dropdown in the sidebar's Portfolio section — the app reloads to show the selected portfolio's data.
Tips¶
- Use a Paper portfolio for testing new strategies before running them in your Live portfolio.
- Each portfolio is completely isolated — strategies, trades, and performance data are separate. This means you can run different strategy sets in different portfolios without interference.
Help & About (Dialog)¶
Access the Help & About dialog from the sidebar. It provides quick reference information and diagnostic tools.
Contents¶
- Version — the current QuantAscent version number
- Log Files — a button to open the log folder containing
app.logand crash reports. Useful for troubleshooting. - System Info — Python version, PySide6 version, and platform details
- Report a Bug — describe the issue and click Submit Bug Report. Your system info and log file are included automatically and the developer is notified by email.
- Licenses — open-source license notices