Portfolio Loading

The portfolio panel on the left side of MantaWealth is where you load the portfolio you want to work with. Once a portfolio is loaded, use Portfolio Modelling to adjust positions and model proposed trades before execution, with every analytical tab updating in real time.

Three ways to load a portfolio

There are effectively three ways to get a portfolio into MantaWealth:

1. Building a portfolio from scratch — create a new portfolio and add its positions by hand, without importing anything.
2. Loading transactions via CSV — create a new portfolio and populate its holdings from a CSV file of trades.
3. Loading via MCP — let an AI assistant build the portfolio for you from documents in almost any format.

Portfolio Selector

The top of the panel contains the portfolio selector dropdown. Click it to switch between any portfolio available in your account. Three action buttons sit beside it:

• + — create a new portfolio
• Filter icon — apply filters to narrow the holdings view
• Delete icon — remove the currently selected portfolio

1) Building a portfolio from scratch

If you don't have any historical transactions to import, you can build a portfolio by hand:

1. Click the + icon.
2. Specify the portfolio's name, currency, and capital (its Available Funds).
3. Press Save.
4. Add instruments using the instrument search to build up the holdings.

Until the portfolio has at least one open position, MantaWealth will show a warning such as "Could not calculate exposure for current portfolio: The portfolio provided does not have any open position." You can safely ignore it — the warning clears as soon as you add your first instrument.

Note: Performance Attribution Analysis is not available for a portfolio built from scratch, as it has no historical data to analyse. To use it, load the portfolio's history instead via Loading transactions via CSV or Loading via MCP.

2) Loading transactions via CSV

When you create a new portfolio with the + button, you can populate its holdings by uploading a CSV file of trades. The file is a comma-delimited, UTF-8 CSV with a required header row, and must be no larger than 1 MB. Columns are matched by exact header name, so the column order is flexible — but the header text must match exactly.

Each row describes a single transaction. Positions are netted from the trades: multiple trades of the same instrument combine into one position, where BUY adds to a long position and SELL reduces it (or opens a short). The portfolio's cash — the Available Funds value in the create-portfolio modal — is entered separately; the CSV contains trades only and has no cash rows.

Columns

Column	Requirement	Description
Ticker	Optional*	Instrument ticker or symbol (e.g. AAPL)
ISIN	Optional*	Instrument ISIN (e.g. US0378331005)
MIC	Optional	Market Identifier Code; if provided, must be exactly 4 characters (e.g. XNGS)
Currency	Conditional	Instrument trading currency (e.g. USD, CHF); effectively required when identifying by Ticker
Direction	Required	BUY or SELL (case-insensitive)
Size	Required	Quantity, a positive number; use a dot as the decimal separator and no thousands separators
Price	Required	Trade price per unit; dot decimal separator, no thousands separators
Date/Time UTC	Required	Trade timestamp in UTC, formatted yyyyMMddTHH:mm:ssZ (e.g. 20230818T14:33:51Z) — no dashes in the date, with a literal T and Z

At least one of Ticker or ISIN must be present in each row.

Validation feedback

On upload, MantaWealth validates each row and shows a per-row status so you can correct problems before importing:

• Valid — the row matched an instrument and will be imported.
• No ISIN or ticker provided — the row has neither identifier.
• Invalid MIC <x> — the MIC is not exactly 4 characters.
• Invalid currency <x> — the currency could not be recognised.
• Could not match <x> to any instrument — the identifier is unknown, the MIC is wrong, or the currency does not match the instrument.
• Invalid direction <x> — the value is not BUY or SELL.

Some problems reject the entire file rather than a single row:

• A missing header row, or a missing required cell.
• A non-numeric Size or Price.
• A wrongly formatted Date/Time UTC value.
• A file larger than 1 MB.

Example

Ticker,ISIN,MIC,Currency,Direction,Size,Price,Date/Time UTC
AAPL,,XNGS,USD,BUY,100,100,20230818T14:33:51Z
,US0378331005,XNGS,USD,SELL,90,120,20230825T14:30:00Z

The first row buys 100 units of Apple, identified by its Ticker (AAPL) on the XNGS market in USD, at a price of 100 on 18 August 2023. The second row sells 90 units of the same instrument — this time identified by its ISIN (US0378331005) — at a price of 120 a week later. Because both trades resolve to the same instrument, they net into a single position of 10 units.

3) Loading via MCP

If you connect an AI assistant to the MantaRisk MCP server, it can create and populate portfolios on your behalf — creating a new portfolio and loading its holdings through the authenticated MantaRisk API, without any manual entry or rigidly formatted CSV.

The real advantage is format flexibility. The CSV route above expects an exact set of columns; an AI assistant does not. It can read holdings from documents in almost any format — a PDF custody statement, an Excel or CSV export, a broker report, an email, even a screenshot of a positions table — extract the instruments, quantities, and prices, resolve them to MantaRisk instruments, and build the corresponding portfolio through MCP. Because the assistant interprets the source for you, there is no need to reshape your data to match a template first.

This makes MCP a practical way to integrate MantaWealth with your existing systems and legacy files: point the assistant at whatever your current tools and archives already produce, and it can turn that into a MantaWealth portfolio — no bespoke export pipeline or manual re-keying required.

See MCP Capabilities for the full list of operations available over MCP.