PortfolIQ

Delete a backtest preset owned by the user. Requires write:plans.

Delete one owned private saved backtest snapshot. Other revisions remain unchanged. Requires write:plans.

Soft-delete a PortfolIQ transaction by id. Requires write:transactions; does not cancel or execute a brokerage order.

Realised-P/L analytics: strategy breakdowns, holding-period stats, win rate, and per-ticker realised totals. Requires read access. May populate or replace the account analytics cache without changing transaction records.

Read-only factual alerts from the user's durable PortfolIQ inbox. Returns alert priority, event context, timestamps, read state, and the account-wide unread count without changing notification state.

Current per-ticker holdings across the user's portfolios, with quantity, cost basis, average cost, market price, market value, unrealized P/L, day change, and open date.

Daily P/L history series (cost basis, market value, unrealised/realised P/L, daily return) used by the dashboard graph. May populate or refresh the account history cache without changing transaction records.

Portfolio performance metrics including YTD, annual returns, and beta from the dashboard source of truth. May populate or replace the account metrics cache without changing transaction records.

Evidence-backed position-plan review insights, attention items, final-review tasks, and historical lessons.

Open one owned private saved backtest snapshot with its exact validated request and complete stored result. The snapshot is returned without recalculation.

List the actual transactions assigned to one owned strategy.

Portfolio summary snapshot: cost basis, market value, unrealised P/L, realised P/L, day change, and cash-flow totals across all portfolios included in totals.

Monthly realised P/L, trading activity, and win-rate calendar.

Import a public marketplace strategy as a private owned copy. Returns an existing active copy, or restores an archived copy and resets its visibility to private. Requires write:plans.

List public strategies available in the PortfolIQ marketplace, including whether the user already imported each strategy.

List the user's portfolios (id, name, currency, default flag, sort order); if the account has exactly one portfolio without a default flag, mark it as default.

List immutable deliberate review snapshots for one owned position plan.

List the user's position plans (per-ticker thesis, risk notes, target, review date, linked strategy).

List the user's own trading strategies, including rules, notes, visibility, and historical metrics.

List the connected user's presets plus public presets for an owned or public strategy family. Each result identifies visibility and whether it is owned. Returns presets only, never run results.

List the connected user's private saved backtest history for one owned strategy, including immutable revision metadata. Returns at most the latest 20 runs.

Recent transactions across the user's portfolios. Returns the most recent page from /api/transactions.

Set the complete display order of all owned portfolios. Requires the write:portfolios scope.

Append an immutable deliberate review while optionally updating current plan fields. Outcome, note, and next review date are required. Requires the write:plans scope.

Run a historical simulation for an owned strategy and save its exact validated request and complete result as a private immutable history snapshot. Pass revisionOf to append an edited rerun to an owned run series; an exact repeat reuses its newest snapshot. May fetch and update shared market-history and split caches. Requires write:plans. Results are not investment advice.

Run an owned or public preset for an owned same-family strategy and save the complete result as a private immutable history snapshot. Pass revisionOf to append an edited rerun to an owned run series; an exact repeat reuses its newest snapshot. May fetch and update shared market-history and split caches. Requires write:plans. Results are not investment advice.

Run a historical simulation for an owned strategy and return split-adjusted OHLC candles, buy/sell actions, signal and execution dates, matched condition ids, action explanations, metrics, equity, trades, and exclusions. May fetch and update shared market-history and split caches. Simulation results are ephemeral; this tool does not save runs or change portfolio transactions. Results are not investment advice.

Run an owned or public backtest preset against 1–8 stocks using the canonical validation, warm-up, split adjustment, and simulation engine. The selected strategy must be owned and in the preset family. Optional assumptions override the preset assumptions. May fetch and update shared market-history and split caches; simulation results remain ephemeral. Results are not investment advice.

Complete one server-issued closing-review task with the user's retrospective assessment. The server preserves immutable FIFO outcomes and requires a retrospective thesis only when the closed position had no saved thesis. Requires write:plans.

Update an owned portfolio's name, currency, default status, or display/inclusion settings. Requires the write:portfolios scope.

Update selected current fields of a position plan without creating a review. Requires the write:plans scope.

Update selected fields of an owned trading strategy. Requires the write:plans scope.

Update an owned reusable backtest preset, including its private or public visibility. Does not store run inputs or results. Requires write:plans.

Correct an existing PortfolIQ transaction. Requires write:transactions; does not modify a brokerage order.