VEEMANDocs
DocumentationSupportOpen Dashboard

Getting started

  • Introduction
  • Quick start
  • Core concepts

Importing data

  • Supported formats
  • How import works
  • Splitting a file
  • Troubleshooting

Building your portfolio

  • Workspace & equity
  • Weights & capital
  • Weekday filter
  • Library
  • Variants & comparison
  • History (undo/redo)
  • Shared spaces

Analytics

  • Metrics reference
  • Charts (deep-dive)
  • Monthly P&L
  • Correlations
  • Strategy comparison
  • Monte Carlo
  • Equity Control
  • Optimization
  • Veeman AI

Reference

  • Keyboard & command palette
  • Exporting data
  • Settings

Technical

  • Architecture
  • API reference
  • Security
  • Your data & privacy
  • Risk disclosure
← PreviousWeekday filterNext →Variants & comparison

Library

The library is your permanent shelf. Unlike the temporary session, anything here is stored on your account until you delete it.

Whose library you are looking at

Above the shelves sits a switch: My library or one of your shared spaces. Inside a space the page looks identical to your own, so the label is what tells you where a save will land, and rows gain three extra actions: Versions, Comments and copy out. In your personal library only the copy-in action appears, and only once you belong to at least one space.

Two kinds of saved object

  • Saved strategy — a single reusable P/L series. Add it to any portfolio you're building later.
  • Saved portfolio — a named snapshot of several strategies plus their settings (weights, capital, mode, and any strategy groups with their size knobs), ready to reload as a fresh session.

Strategies born from a backtest

If the Research section is enabled for your account, the backtests you save there are strategies too, and they live on this same shelf: one list, sorted and searched together with the ones you imported from CSV. A backtest is not a different kind of object, it just has a different origin — so it can be added to a session, weighted, sized and saved inside a portfolio exactly like any other strategy.

You can tell them apart at a glance: a row born from a backtest carries a Backtest badge, and the toolbar gains an Origin filter (All · Imported · Backtests). Only the exception is marked; imported strategies stay unlabelled.

The numbers are the library's, not the run's

A backtest row shows the same metrics as every other row: computed by the portfolio engine from the daily series. They are not the statistics the Research run reported, which are tied to the capital and sizing of that run. If the two were mixed, sorting by Sharpe would be comparing numbers that don't mean the same thing. Promoting a backtest (below) therefore never changes its numbers.

Until you touch it, a backtest row is a projection: nothing is copied, and the backtest lives only in its Research archive. The copy is made the moment you need one — renaming it or giving it a tag promotes it to a full library strategy, which is also what unlocks versions, comments and copying into a shared space. You don't have to ask for this; it happens as you work.

Saving

From an active session, save the current portfolio under a name and, optionally, a description — a short note on why you put this mix together, so the reasoning is still there when you come back. You can also attach tags at this point (free labels like 0dte or live) to group and find the portfolio later. The same Save action lives in the workspace and the status bar, and right here in the library — on the saved-portfolios header — so you can capture the session you're working on without leaving the shelf; it appears only when there's something to save (a fresh upload, or unsaved changes to a loaded portfolio, where it turns into Update). You can also save an individual strategy to reuse it; strategies are tagged from the library (see below) rather than at save time. For Option Omega strategies, the trade-level CSV is kept alongside — for both saved strategies and saved portfolios — so they stay usable for per-strategy dynamic sizing after you reload them.

Groups and the size knob when saving

A saved portfolio keeps groups and base weights as two separate levers, so reloading it restores both and the knob still works. A saved strategy leaves its group behind — there is no sleeve to travel with it — so its exposure is baked into the saved weight: what you reload matches what you were looking at. See Group scale.

Next to the save action, the saved-portfolios header also carries a New portfolio button. Here in the library it works differently from the one in the workspace: it uploads the CSVs you pick, asks for a name (and an optional description), and saves the result straight to the shelf as a new saved portfolio — your current working session is left untouched, and you stay in the library. Use it to stock the library from files without disturbing what you're analysing. (If any file needs an import review, load it from New session in the workspace instead, where the mapping dialog is available — see Starting a new session.)

The portfolio card

Each saved portfolio appears as a card carrying:

  • a key-metrics grid — the portfolio's headline numbers at a glance. By default it shows P/L (net profit), MAR (CAGR divided by the absolute Max Drawdown %), CAGR, Max DD %, Sortino, and Profit Factor (gross profit divided by gross loss — green above 1, red below), but you choose which metrics appear from the Metrics picker in the toolbar (pick 2 to 6; the choice is remembered per device and also applies to the list view). The full pool adds Sharpe, Win Rate, and Volatility. Values reflect the portfolio exactly as the workspace computes it — its weights, starting capital, weekday filters, and per-strategy sizing: a portfolio saved with dynamic sizing (scaling contracts) or compounding shows those numbers, not a flat one-contract equity. Re-save after changing sizing and the card follows. Values are tinted by sign (Max DD always reads negative);
  • its description, when you wrote one;
  • its tags, as small chips (click a chip to filter the list by it);
  • Load, plus quiet actions to pin it as a variant, edit, or delete it.

Saved strategies use the same key-metrics display — the metric values you'd see on a portfolio appear on each saved strategy too (computed from its stored series on a single contract), driven by the same Metrics picker and card/list toggle. The difference is the primary action: instead of Load, a strategy offers Add (or Load, when no session is open yet) to drop it into the portfolio you're building, with a quiet status dot that turns to the accent color once it's in the active session.

Use the pencil to change a portfolio's name, description, or tags at any time — without reloading it — which is handy when you only remember why later. Saved strategies carry the same pencil for editing their name and tags. Editing metadata never touches the saved strategies or settings.

Finding things

Both lists — saved portfolios and saved strategies — sit under a toolbar that filters and reorders them instantly (everything happens in the browser, with no extra loading):

  • Search by name to narrow a long shelf as you type.
  • Sort by P/L, Date, CAGR, Max DD, Name, Sortino, or Profit Factor, and flip the direction (ascending or descending). The performance metrics are computed from each saved item's stored series, so the ordering reflects the real numbers.
  • Filter by tag: pick one or more tag chips to show only the items carrying any of them.
  • Filter by origin (saved strategies only, and only once both origins exist): show everything, just the ones you imported, or just the ones that came from a backtest.
  • Card or list: both saved portfolios and saved strategies can be shown as cards (the rich grid above) or as a compact list — handier once you have many — using the view toggle on the right of the toolbar. Your choice is remembered per list. The list keeps the same metrics and tags on one dense row.

The same search, sort and tag filters follow you into the Workspace: its Add and + variant menus end with Browse the library…, which opens this toolbar in a picker where you can tick several entries and bring them in together — and once your shelf grows past eight entries those menus stop listing everything, showing only what you used most recently. Tags you set here are what keep that picker fast.

Loading and deleting

  • Load a saved portfolio to start a new session from it — your live work is replaced by the loaded set, and you land straight in the workspace with the portfolio open. If the current session has unsaved work, you're asked to confirm first, so a stray click can't discard it.
  • Saved items also surface on the Overview as quick load cards, each showing its equity curve and net P/L at a glance. That row is ordered by last use — the portfolio you opened (or saved) most recently comes first — and each card carries the date of that last use. It stops at the six most recent: past that, the row header turns into a shown-of-total link back to this library, which is where the full shelf lives. Portfolios you haven't opened since the app started keeping track fall back to their save date. Renaming or re-tagging a portfolio isn't a use and doesn't move it. The record is kept on your account, so the order follows you across browsers and devices; the library's own toolbar keeps whatever sort you pick there.
  • Delete removes an item from your account permanently.
  • A backtest row that hasn't been promoted yet offers Hide from library instead of Delete, because there is nothing of it on this shelf to delete: it only stops showing here, and the backtest itself stays in its Research archive. To bring one back, use the hidden chip above the list: it appears as soon as anything is hidden, shows them dimmed, and each gets a Restore button. The choice is yours alone — inside a shared space, hiding a row doesn't hide it from anyone else.
  • Hiding is the first step, not the only one: a hidden row also offers Delete the backtest, which removes it from the Research archive for good. It is offered only there, once you have already put the row aside, so the library cannot destroy a backtest someone is still working on. Strategies and portfolios you already saved from that backtest are untouched — they carry their own copy of the series.

Library vs. variants

Use the library to keep reusable building blocks and portfolios you'll come back to. Use variants to freeze and compare specific configurations of the session you're working on right now.