Setup Guide

Get up and running in minutes.

Everything you need to import your portfolio data, add your holdings, and run your first AI pipeline — with step-by-step instructions for Wealthsimple, Questrade, Robinhood, IBKR, and more.

Launch App →

7-day free trial available

Welcome to Alphenzi

Alphenzi gives you institutional-grade portfolio analytics — weekly alpha vs SPY, AI-mapped news impact, drawdown monitoring, and an AI copilot that knows your exact holdings. Here's what you'll set up and in what order.

01

Upload your portfolio history

Export your weekly portfolio value from your brokerage and upload it as an Excel file. This powers alpha, drawdown, and volatility charts.

Upload Data guide →
02

Add your current holdings

Enter each stock or ETF you hold — ticker, number of shares, average cost per share. Alphenzi fetches live prices automatically.

Add Holdings guide →
03

Read your weekly dashboard

Every Monday: refresh the dashboard to see your latest alpha vs SPY, drawdown vs your rulebook thresholds, and portfolio risk board.

Dashboard guide →
04

Run the AI pipeline

Start the AI pipeline from the sidebar. In 1–2 minutes it generates recommendations, news impact analysis, and a portfolio copilot briefing.

AI Pipeline guide →

What data does Alphenzi need?

Alphenzi needs two types of data from you — your portfolio history (for performance analytics) and your current holdings (for live prices and AI analysis). These come from different places in your brokerage.

Portfolio History
An Excel file with weekly total portfolio value snapshots. Used for alpha vs SPY, drawdown, and volatility charts. You create this from your brokerage's account history or performance page.
Current Holdings
Each position you currently hold: ticker, number of shares, and your average cost per share. Entered manually in the Holdings tab. Alphenzi fetches live prices from Yahoo Finance.
Brokerage connection?
Never required. Alphenzi does not connect to your brokerage. No login credentials or account numbers are ever shared. You upload a file you export yourself.
Tip: Start with just holdings. If you're in a hurry, skip the portfolio history for now and just add your holdings. You'll get live prices, day-change tracking, and P&L immediately. Upload the portfolio history later to unlock the alpha and drawdown charts.

Ready to start? Sign up free — Observer tier gives you the dashboard, holdings tracking, and one AI pipeline test run at no cost. Upgrade to Analyst for the 7-day free trial.

Start free → See pricing

Upload your portfolio history

Your portfolio history is a spreadsheet with weekly total portfolio values. Alphenzi uses this to calculate weekly alpha vs SPY, drawdown, rolling volatility, and the performance charts. Select your brokerage below for step-by-step export instructions.

What format does Alphenzi expect? An Excel (.xlsx) or CSV file where each row is a week, with at minimum a date and your total portfolio value in CAD or USD. Download the official template from the Upload Data tab inside the app — it shows the exact column names required.

Wealthsimple

Wealthsimple Trade and Wealthsimple Invest both provide account performance history. Here's how to get your weekly values.

Heads up: Wealthsimple Trade does not directly export a weekly performance CSV. You'll pull your total portfolio value from the Account History page or the Performance chart, then fill it into the Alphenzi Excel template each week. This takes about 2 minutes per entry.
1

Open Wealthsimple Trade / Invest

Log in at my.wealthsimple.com or the mobile app. Select the account you want to track (TFSA, RRSP, Personal, etc.).

2

Navigate to Account History or Performance

On the web app: click your account → Activity tab for transaction history. For portfolio value, click the Performance chart and hover on the end of each Friday to read the total value.

On mobile: tap the portfolio value chart, then drag your finger to each Friday's endpoint to see the exact closing value for that week.
3

Download the Alphenzi Excel template

In Alphenzi, go to Upload Data in the left sidebar. Click Download Template. Open it in Excel or Google Sheets.

4

Fill in your weekly values

For each Friday going back as far as you want (minimum 4 weeks recommended, ideally 1 year), enter the date (YYYY-MM-DD) and your total portfolio value in CAD. Leave the SPY benchmark column blank — Alphenzi fetches that automatically.

Example: 2024-12-06 → 48250.00 (CAD)
5

Upload to Alphenzi

Back in Alphenzi, go to Upload Data and drag your completed Excel file into the upload area. Click Import. The dashboard populates in seconds.


Exporting your transaction activity (optional)

If you want a full transaction log for your records: Wealthsimple Web → Activity → filter by date range → click the Download icon (CSV). This is not required by Alphenzi but is useful for building your own cost-basis spreadsheet.

Questrade

Questrade's Activity Report gives you a date-stamped account value history you can use to fill the Alphenzi template.

1

Log in to Questrade

Go to login.questrade.com and sign in. Navigate to My Accounts from the top menu.

2

Open Reports → Account Activity

Click Reports in the top navigation, then select Account Activity. Set the date range (select your desired start date to today) and your account.

3

Download the CSV

Click Download → select CSV. The file contains daily balance history. You'll use the Friday end-of-day values to fill the Alphenzi template.

Filter the CSV by weekday = Friday (or the last trading day of each week) to quickly extract the weekly closing portfolio value.
4

Fill the Alphenzi template

Download the Alphenzi Excel template from Upload Data in the app. Copy your Friday dates and portfolio values into the template. Save as .xlsx and upload.

Questrade tip: If you have both a margin account and a TFSA/RRSP, you can combine them by summing the portfolio values for each week before entering them into the template. Alphenzi treats all uploaded data as one combined portfolio.

Robinhood

Robinhood provides account statements and tax documents but no direct weekly-value CSV. You'll use the performance graph to record your weekly values.

USD accounts: Robinhood accounts are USD-denominated. When uploading to Alphenzi, select USD as your currency in the upload settings. Alphenzi will convert to CAD automatically if needed using live FX rates.
1

Open Robinhood Web or App

Log in at robinhood.com or on mobile. Go to your Portfolio view.

2

Use the Performance chart

On Web: click your portfolio value chart, then switch to 1Y or All view. Hover over each Friday's data point to see the exact closing value. Record these in a spreadsheet.

On mobile: tap the chart and drag slowly to each Friday to record the value. The date and value appear at the top of the chart.
3

Download account statements (optional)

For a full transaction record: Robinhood App → AccountStatements & HistoryBrokerage Statements. These are PDFs, not CSVs — they're useful for reference but not directly imported into Alphenzi.

4

Fill and upload the Alphenzi template

Download the Alphenzi Excel template, fill in your Friday dates and USD portfolio values, and upload via Upload Data. Select USD currency in the upload form.

Interactive Brokers (IBKR)

IBKR's Activity Statement is one of the most detailed exports available and is the easiest to use with Alphenzi.

1

Log in to Client Portal

Go to clientportal.ibkr.com and sign in. From the top menu, click Performance & Reports.

2

Go to Statements → Activity

Click StatementsActivity. Set the period to Custom Date Range covering your desired history (e.g. past 1 year). Set the format to CSV.

3

Download the CSV

Click Run Statement then Download. The CSV contains a Net Asset Value section with daily account totals in your base currency.

Open the CSV in Excel. Look for the section labeled Net Asset Value. The "Total" column there is your portfolio value each day. Filter for Fridays (or last trading day of the week).
4

Fill the Alphenzi template

Copy the Friday dates and corresponding "Total" NAV values into the Alphenzi Excel template. Upload via Upload Data. IBKR accounts are typically USD — select USD in the upload form.

IBKR Pro tip: IBKR's "Flex Query" feature (under Reports → Flex Queries) lets you create a custom report that outputs exactly weekly NAV totals. Once set up, you can run this report weekly and upload the output directly — no manual filtering needed.

TD WebBroker

TD WebBroker provides account history and eStatements. Here's how to get the data you need for Alphenzi.

1

Log in to TD WebBroker

Go to webbroker.td.com and sign in with your TD credentials. Select your investment account from the account dropdown.

2

Navigate to Accounts → Holdings & History

From the top menu, click AccountsHoldings & Activity. Choose the Activity tab and set your date range.

3

Download Account History

Look for a Download or Export button (usually a spreadsheet icon). Download as CSV or Excel. Alternatively, access eStatements from Documents & Statements — monthly statements show your end-of-month portfolio value.

If TD doesn't export a daily balance CSV directly, use the Portfolio Overview chart: hover on each Friday to record the total value, similar to the Wealthsimple approach.
4

Fill and upload the Alphenzi template

Use the Friday portfolio values to fill the Alphenzi Excel template. TD accounts can be CAD or USD — match the currency to the account's base currency in the upload form.

Manual Entry / Custom Excel

Already track your portfolio in a spreadsheet? Great — you're halfway there. Here's the exact format Alphenzi expects and how to map your columns.

Required columns

Column nameFormatRequired?Description
dateYYYY-MM-DDRequiredThe Friday (or last trading day) of each week
total_valueNumber (e.g. 48250.00)RequiredYour total portfolio value in your base currency (no $ symbol)
cost_basisNumberOptionalTotal amount invested to date. If omitted, Alphenzi uses the first week's value as baseline.
benchmark_returnDecimal (e.g. 0.0123)OptionalSPY weekly return. If left blank, Alphenzi fetches this automatically from Yahoo Finance.
currencyCAD or USDOptionalCan also be specified in the upload form instead of per-row.
Download the official template: In the Alphenzi app, go to Upload DataDownload Template. This gives you a pre-formatted Excel with the exact column headers, data-type hints, and an example row filled in.
1

Open the template in Excel or Google Sheets

Download from Upload Data → Download Template. Keep the header row exactly as-is — column names are case-sensitive.

2

Enter one row per week

Each row = one Friday (or last trading day of the week). Go back as far as you have data — minimum 4 weeks for alpha calculations, ideally 26–52 weeks for full metrics.

2024-01-05 → 41200.00
2024-01-12 → 42450.00
2024-01-19 → 41900.00
3

Save as .xlsx and upload

File → Save As → Excel Workbook (.xlsx). In Alphenzi, go to Upload Data, drag in the file, and click Import. Processing takes a few seconds.

4

Add a new row each week going forward

Every Monday, open your tracker, add last Friday's closing value, save the file, and re-upload. The dashboard updates with the new week's data in seconds.

You can also use the Manual Week Entry button in Upload Data to add a single week without re-uploading the entire file (Analyst tier).

Got your data ready? Go to Upload Data in the app and drag in your Excel file. The dashboard populates in seconds. Then add your holdings to unlock live prices and AI analysis.

Open Upload Data →

Add your current holdings

Holdings are the stocks and ETFs you currently own. You enter them manually — Alphenzi then fetches live prices from Yahoo Finance every time you refresh, calculates day/week/month changes, and uses your holdings for AI analysis.

What you'll need from your brokerage: For each position: the ticker symbol, the number of shares you hold, and your average cost per share (what you paid, not the current price). This is shown in your brokerage's "Positions" or "Portfolio" view.
1

Navigate to Holdings in Alphenzi

Click Holdings in the left sidebar. You'll see a list of your current positions (empty if you haven't added any yet) and an Add Holding button.

2

Open your brokerage's positions view

In a separate tab, open your brokerage and navigate to your positions / portfolio view. You need three numbers per holding: ticker symbol, shares held, average cost per share.

Finding average cost:
Wealthsimple: Tap the stock → "Your average cost"
Questrade: Positions tab → "Avg Cost" column
IBKR: Portfolio → "Avg Cost" or "Average Price"
TD: Holdings → "Adjusted Cost Base ÷ Quantity"
3

Add each holding

Click Add Holding in Alphenzi. Enter the ticker (e.g. NVDA, SHOP.TO, XIC.TO), shares, and average cost. Select CAD or USD to match how you bought the stock. Click Save.

For TSX-listed stocks and ETFs, append .TO to the ticker (e.g. RY.TO for Royal Bank, XIU.TO for iShares S&P/TSX 60). For TSX Venture, use .V.
4

Repeat for all positions

Add each stock, ETF, or fund you hold. Alphenzi supports any ticker available on Yahoo Finance — TSX, NYSE, NASDAQ, TSX Venture, and most international exchanges.

5

Refresh Holdings to see live prices

Once all holdings are added, click Refresh at the top of the Holdings page. Alphenzi fetches current prices from Yahoo Finance and calculates your portfolio weights, unrealized P&L, day change, and more.


Common questions about holdings

I own fractional shares. What do I enter?

Enter the exact fractional amount (e.g. 1.735 shares). Alphenzi handles decimal share counts.

My average cost is in USD but the stock trades in CAD. What do I do?

Select the currency that matches how your brokerage reports the cost (the currency you paid in). Alphenzi handles the FX conversion at the portfolio level using live CAD/USD rates.

Do I need to update holdings when I buy or sell?

Yes. After a trade, update your holding's share count and average cost to reflect the new position. For sells, either update the share count or delete the holding if fully exited.

Observer tier is limited to 5 holdings. What counts?

Each individual ticker counts as one holding. Upgrade to Analyst (7-day free trial) for unlimited holdings. Your holdings data is preserved when you upgrade or downgrade.

Need unlimited holdings? The Observer tier is limited to 5. Analyst gives you unlimited holdings plus full AI features with a 7-day trial.

Start free trial →

Reading the Weekly Dashboard

The Weekly Dashboard is your primary Monday-morning view. It combines your uploaded portfolio history with live prices and AI analysis into a single command center. Here's what each section means.

α

Weekly Alpha vs SPY

How much you outperformed (or underperformed) the S&P 500 this week. Positive alpha means your portfolio beat the index. The "4W Rolling Alpha" smooths out single-week noise. "Cumulative Alpha" shows your lifetime edge vs SPY since your first data point.

DD

Current Drawdown

How far your portfolio has fallen from its highest-ever value (the "peak"). A drawdown of -5% means you're currently 5% below your all-time high. This is compared against your Rulebook thresholds: the Defensive level (where you should start reducing risk) and the Hard Stop (your absolute exit threshold).

Set your own drawdown thresholds in Risk Playbook. The defaults (Defensive: -7%, Hard Stop: -10%) are conservative. Adjust to match your personal risk tolerance.

Performance Charts

Four charts you can swipe or scroll through: Portfolio Value vs Peak, Drawdown vs Rulebook, Rolling Alpha, and Rolling 8W Volatility. These are all calculated from your uploaded weekly data. They update each time you add a new week's data.

AI Portfolio Risk Board

Four risk scores (Concentration, Drawdown, Volatility, News Shock) each rated 0–100 and classified as Low / Moderate / High / Critical. These are generated by the AI pipeline after it reads your holdings, portfolio data, and recent news.

The Risk Board only populates after you've run the AI Pipeline at least once. Before then, you'll see a "Waiting for AI summaries" placeholder.
📋

AI Execution Queue

Prioritized action items generated from the AI pipeline: BUY, HOLD, or TRIM signals for your holdings, ranked by urgency. "Act Now" items are the highest conviction, time-sensitive signals. "Monitor" items are lower priority watches.

📰

Market Sentiment (Fear & Greed)

The CNN Fear & Greed Index shown live — a broad market sentiment gauge from 0 (Extreme Fear) to 100 (Extreme Greed). Not portfolio-specific, but useful context for interpreting your alpha and drawdown in the current macro environment.


Monday morning workflow

1

Add last Friday's portfolio value

Go to Upload Data → Manual Week Entry (or re-upload your updated Excel). Takes 30 seconds.

2

Refresh the dashboard

Click Refresh on the dashboard. Alpha, drawdown, and all charts update in seconds.

3

Restart the AI pipeline

Click "Restart AI Pipeline" in the sidebar. In 1–2 minutes, the risk board, execution queue, and recommendations all regenerate with the latest data and news.

4

Review the AI Copilot

Go to AI Copilot and ask any question about your portfolio. It now has the latest context from step 3.

The AI Pipeline

The AI pipeline reads your portfolio data, current holdings, live news, and risk state to generate three AI summaries: a dashboard briefing with recommendations, a portfolio-mapped news impact summary, and an AI Copilot context brief. All three are used across the app.

Time to complete
1–2 min

Depends on AI provider load. Progress is shown in the sidebar.

When to run it
Weekly

Run every Monday after uploading last week's portfolio value. Restart any time news breaks.

Observer tier
1 free run

Observer gets one free full pipeline run. Analyst (7-day trial) gives unlimited runs.

Before you run the pipeline: Make sure you've uploaded at least a few weeks of portfolio history AND added your current holdings. The AI needs both to generate useful analysis. Running it with no data results in generic output.
1

Locate the AI Pipeline panel in the sidebar

In the left sidebar, find the AI Pipeline section. It shows three indicators: Dashboard, News, and Assistant — each lights up green when its summary is ready.

2

Click "Start AI Pipeline"

The button triggers all three AI summaries in parallel. A progress indicator ("AI Warming...") appears. The pipeline runs in the background — you can navigate to other pages while it works.

3

Watch the indicators turn green

As each summary completes, its indicator turns green and the dashboard, news, and copilot sections populate with AI content. The sidebar shows "AI Ready" when all three are done.

4

Review your AI outputs

Weekly Dashboard → AI Risk Board, Execution Queue, Recommendations, Buy Watchlist
News Flow → AI news impact mapped to your holdings
AI Copilot → Portfolio-aware chatbot with full context

5

Restart or clear the pipeline

Use Restart AI Pipeline to regenerate all summaries (e.g. after news breaks mid-week, or after uploading new data). Use Clear AI Pipeline to reset all summaries and start fresh.


What AI providers does Alphenzi use?

Alphenzi uses a provider chain: Gemini (Flash)OpenAI (GPT-4o mini)Deterministic fallback. If the primary AI is unavailable, the next in line activates automatically. You can see the active provider in the AI mode label on the dashboard.

Command tier users get GPT-4o (full model) instead of mini — higher quality analysis, especially for complex portfolio questions in the AI Copilot.

Your data and AI: Portfolio context is sent to the configured AI provider only when the pipeline runs or when you use the AI Copilot. You can disable AI at any time from Settings — deterministic analytics (alpha, drawdown, charts) continue working with no AI at all.

Ready to run your first AI pipeline? Start the 7-day Analyst trial and unlock unlimited AI pipeline runs, recommendations, and the full AI Copilot.

Start free trial → Open the app