addPortfolioCash
ChatGPTRecord cash in an owned, unlocked manual portfolio. Positive amount deposits, negative amount withdraws; zero is invalid. Amount and commission are in input.currency, not automatically converted to the portfolio currency (GBX means pence). The service updates the balance, creates a CASH_IN/CASH_OUT transaction and refreshes history. It can produce a negative balance. This adds an operation, not a replacement balance; retrying repeats it. No data is returned. Call listPortfolios with portfolioId and includeCashes=true to see stored balances, or listPortfolioTransactions for the generated transaction.
addPortfolioPosition
ChatGPTRecord a buy or sell in an owned, unlocked manual portfolio. Positive quantity buys or reinforces, negative quantity sells or closes; selling beyond holdings is rejected. Use a canonical ticker from searchSecurities; a custom/unrecognized ticker requires currency. A recognized security uses its stored currency. Price is per unit and commission is a fee in that currency (GBX means pence, not GBP). The operation updates cash, creates a market transaction timestamped now, and refreshes history. Cash may become negative. This adds a trade, not a replacement holding; retrying repeats it. No data is returned. Read listPortfolios with includePositions and includeCashes true to see the result, or listPortfolioTransactions for the generated transaction.
analyzeSecurities
ChatGPTRetrieve detailed market data for a security by ticker symbol. Available to every authenticated connector identity, including one that has not created an Investminder profile yet, for QUOTES, PERFORMANCE, TECHNICAL_INDICATORS and VOLUME_PROFILE. FINANCIAL_STATEMENTS, DIVIDENDS and PER require an Investminder profile because its tier sets the available history. Pass 'language' as the language of the conversation: en, fr, es or de. If the conversation language is not supported, pass en. Use 'fields' to specify which data sections to retrieve (only those sections are fetched): QUOTES, PERFORMANCE, TECHNICAL_INDICATORS, FINANCIAL_STATEMENTS, DIVIDENDS, VOLUME_PROFILE, PER. Optional date range: startDate and endDate (default endDate: today). Two frequencies, each governing its own sections and each optional: 'quoteFrequency' (DAILY by default) for QUOTES and PER, 'statementFrequency' (YEARLY by default) for FINANCIAL_STATEMENTS. The other sections have a frequency of their own and ignore both. Ask for QUOTES and FINANCIAL_STATEMENTS in the same call and each is read at its own frequency. Every response carries 'earliestDate' and 'latestDate', the first and last known quote dates of the security - the range 'startDate' and 'endDate' can usefully span, and the as-of date of the data rather than the date of its computation. A ticker that Investminder does not cover returns 'found': false with a 'message' instead of data: it is not an analysis and must not be presented as one. Then look for an equivalent security with queries of your choice: searchSecurities by name, issuer, ISIN or the ticker without its exchange suffix, or screenSecurities by criteria such as asset class, sector, country or stock index - and retry with a ticker they return.
connectPortfolio
ChatGPTStart a NEW brokerage/banking connection for the authenticated user, subject to their connection quota. Choose institutionId from listInstitutions. Returns a hosted authorization URL to open in the browser; the user completes authorization directly with the provider. Never ask for bank credentials in chat. The provider's existing webhooks then create and synchronize the portfolio; returning a URL does not mean a portfolio already exists. After completing authorization, call listPortfolios and optionally request positions/cashes. Existing provider defaults apply (Powens EUR, Snaptrade USD). This tool neither reconnects nor converts an existing manual portfolio, and repeated calls initiate new authorizations.
createPortfolio
ChatGPTCreate an empty manual portfolio for the authenticated user, subject to their account quota. Ask for the portfolio currency; it is a holding currency, not a billing currency. A duplicate name creates another portfolio with a numeric suffix: this is not idempotent. If a previous call's outcome is uncertain, inspect listPortfolios before retrying. Returns a compact portfolio summary. Then use addPortfolioCash and addPortfolioPosition to record cash and trades; use connectPortfolio instead for a synchronized brokerage.
createStrategy
ChatGPTCreate an investment strategy, in DRAFT status, ready to be backtested. 'definition' is always required: to start from a pre-built strategy, read it with listPreBuiltStrategies and send back its definition, adjusted or not. 'name' creates a new strategy, 'strategyId' starts a new draft on one of the strategies of the user instead (a strategy holds a single draft at a time). The 'definition' describes the strategy, every field is documented in the schema; the model drives the rest: a REBALANCED strategy fills percentTarget on its allocations (summing to 100) and leaves percentMax, sharesMax and valueAveraging null, a PROGRESSIVE one does the opposite, a RANKED one lists 2 to 50 candidate tickers with no weight, fills 'ranking' and leaves dca and valueAveraging null. Use searchSecurities, screenSecurities or listScreeners to pick the tickers of the allocations: a ticker no security is known under is rejected. 'constraints' restrict the strategy: optional for a PROGRESSIVE or RANKED strategy, required with the asset classes of its allocations for a REBALANCED one; the constraints of a pre-built strategy can be sent back as is. Returns the strategy and its draft; its strategyId feeds updateStrategy and startBacktest.
deleteStrategy
ChatGPTDelete the draft of a strategy of the authenticated user, along with the backtests of that draft. The strategy itself is deleted only when the draft was the only version it had - which is the case for a strategy an agent created and never published; 'strategyDeleted' in the response says whether it happened. A published or archived strategy has no draft and cannot be deleted here, and neither can a locked one.
getCorrelationMatrix
ChatGPTCalculate the Pearson correlation matrix between multiple securities over a date range. Requires between 2 and 20 tickers. Correlation is computed on daily returns. Tickers that Investminder does not cover are left out of the matrix and listed in 'unknownTickers': tell the user, and look for an equivalent security with searchSecurities or screenSecurities if needed. The call fails when fewer than 2 tickers are covered.
linkPortfolioStrategy
ChatGPTHave an owned, unlocked portfolio follow a published, unlocked strategy of the authenticated user: the strategy is then tracked against the holdings of the portfolio and alerts are sent when it calls for a trade. Tracking and alerts run on a paid plan only, ESSENTIAL or higher: on the free BASIC plan the link is saved but no alert is sent until the account is upgraded. Publish the strategy with publishStrategy first. A portfolio follows a single strategy and a strategy is followed by a single portfolio: a portfolio already linked to another strategy, or a strategy already linked to another portfolio, is rejected; nothing is unlinked here. Calling it again with the same portfolio and strategy changes nothing. Returns the compact portfolio summary, with its strategyId. Schema version: 0.55.0.
listBacktests
ChatGPTList backtests and read their results. 'type' selects the catalog: USER for the backtests of the authenticated user, PRE_BUILT for the reference backtests of a pre-built strategy. One of 'strategyId' or 'backtestId' is required, and they do not return the same thing: 'strategyId' gives the backtests of every version of that strategy with only the performance metrics of their results, 'backtestId' gives that one backtest with its results - which is how a backtest started with startBacktest is polled, until its status is COMPLETED (results available) or FAILED (see the error field). Results contain both the strategy performance and the benchmark performance. Optional 'fields' selects the parts of the results to return, and only applies when 'backtestId' is provided. Omitted, it returns a summary: the performance metrics. Ask for ANNUAL_RETURNS, HOLDINGS, TRANSACTIONS or DIVIDENDS only when the analysis needs the underlying series - holdings, transactions and dividends are daily and large. Backtests are listed newest first. The response is a page: 'items', plus 'total' (matches before paging), 'size' (default 10, max 50), 'hasMore' and 'nextCursor'. To read the next page, pass 'nextCursor' as 'after'.
listInstitutions
ChatGPTList all supported stored financial institutions. Takes no parameters and returns the complete catalog, without filtering or pagination, including each institution's canonical ID, name and countries. Pass the selected ID to connectPortfolio.
listPortfolioTransactions
ChatGPTRead stored transactions of an owned, unlocked portfolio, newest first, with stable datetime/ID ordering. Returns items, total matches, size, nextCursor and hasMore. Size defaults to 10, maximum 50. Omit after on the first call; pass nextCursor unchanged to get the next page with the same portfolio and filters. Optional minDatetime/maxDatetime are inclusive ISO local datetimes WITHOUT an offset, e.g. 2026-01-01T00:00:00, matching stored query semantics; returned datetimes retain their offsets. Amount and commission are in each transaction's currency, with direction given by type; there is no FX aggregation. This does not start synchronization or guarantee lifetime brokerage history: existing provider imports initially fetch up to 1000 entries starting 92 days back. An empty list does not prove the brokerage account has never had transactions.
listPortfolios
ChatGPTRead all portfolios of the authenticated user, or one by portfolioId, as a complete list without pagination. Returns compact summaries by default. Set includePositions and/or includeCashes true for complete nested open holdings and currency balances. Closed positions are excluded. Unrequested collections are omitted; requested empty collections are []. Locked portfolios retain their summary but omit positions/cashes even when requested: this means restricted access, not zero holdings. Prices are per unit in the position currency, quantities are security units, cash amounts are balances in each currency, possibly negative; no FX conversion. Null prices mean unavailable, and tickerRecognized=false identifies a custom/unrecognized security. syncStatus contains only stored enabled/lastSync, not a live connection-session state. This never starts synchronization. For history, call listPortfolioTransactions separately.
listPreBuiltStrategies
ChatGPTList the ready-made strategies of the catalog, the ones available for the account tier. The response is always a page: 'items', plus 'total' (matches before paging), 'offset', 'size' and 'hasMore'. Listing several strategies leaves their 'definition' null and keeps only their NAME and DESCRIPTION overviews, because the whole catalog in full does not fit in one response; ask for a single strategy with 'strategyId' to get its definition and all of its overviews - target, risk, reward, indicator, comment. Everything else - tier, classification, variants, constraints - is always returned. A strategy above the tier of the account is redacted by the server: it keeps its id, name and tier but carries no definition even when read alone, and no classification, so a classification filter never matches it. Optional 'approach', 'diversification', 'activity' and 'tier' filter the catalog. Optional 'size' (default 10, max 50) and 'offset' page through the matches. A pre-built strategy is read only: to backtest or tweak it, read it alone and pass its definition back to createStrategy.
listScreeners
ChatGPTList the screeners saved by the authenticated user, with the criteria they filter on. Pass 'screenerId' to target a single screener, otherwise the screeners of the user are returned in alphabetical order. Criteria use the saved screener format: field, comparator and a string value. To use them in screenSecurities, convert comparator to operator and value to the type declared by its input schema. Use the resulting tickers in createStrategy. An empty criteria list cannot be replayed in screenSecurities. The response is a page: 'items', plus 'total', 'offset', 'size' (default 10, max 50) and 'hasMore'.
listUserStrategies
ChatGPTList the investment strategies of the authenticated user, each with its editable draft. The response is always a page: 'items', plus 'total' (matches before paging), 'offset', 'size' and 'hasMore'. Listing several strategies leaves the 'definition' of their drafts null; ask for a single strategy with 'strategyId' to get the definition of its draft. A null 'draft' means the strategy has been published or archived: call createStrategy with its strategyId to start a new draft before updating or backtesting it. A locked strategy is read only until the account tier is upgraded, and never carries a draft. Optional 'size' (default 10, max 50) and 'offset' page through the strategies.
publishStrategy
ChatGPTPublish the draft of a strategy of the authenticated user: the draft becomes the live version, starting today, the version a portfolio follows and alerts are sent for. Signals and alerts are available on a paid plan only, ESSENTIAL or higher: on the free BASIC plan the strategy is published but sends no signal until the account is upgraded. The previous live version, if any, is archived and its backtests are deleted. No backtest is required beforehand. The first publication of a strategy counts against the number of live strategies the plan allows; publishing a new draft of a strategy already live does not. Calling it again on a strategy already published, with no new draft, changes nothing and returns its live version. Returns the strategy with its live version and a null draft; call linkPortfolioStrategy next to have one of the portfolios of the user follow it. Schema version: 0.55.0.
screenSecurities
ChatGPTSelect securities with structured criteria, combined with AND. Each criterion has field, operator and value; the schema lists valid combinations. Example: [{"field":"assetClass","operator":"EQUALS","value":"STOCK"}, {"field":"roe","operator":"HIGHER_THAN","value":15}]. Use each field at most once; multiple thresholds on the same field are not supported. A stock can belong to several stockIndex values; a criterion selects constituents of that index. Catalog text values are matched ignoring case and separators. Available to every authenticated connector identity, including without an Investminder profile. For a name, ticker or ISIN, use searchSecurities. Pass the conversation language (en, fr, es, de), or en if unsupported. To replay a saved screener, read listScreeners and convert comparator to operator and its string values to the types declared by this schema. A result carries the identity of the security only: id, ticker, isin, name, assetClass and currency. Add 'fields' to get more - DESCRIPTION for the prose describing the company or the fund, PERFORMANCE for the metrics and the scores - and expect a much larger response. The response is a page: 'items', plus 'total' - how many securities match the criteria, not how many are returned - 'offset', 'size' (default 10, max 50) and 'hasMore'. A 'total' far above 'size' means the criteria are loose, and narrowing them beats paging through them.
searchSecurities
ChatGPTFind securities by name, ticker or ISIN. Available to every authenticated connector identity, including one that has not created an Investminder profile yet. Pass 'language' as the language of the conversation: en, fr, es or de. If the conversation language is not supported, pass en. To select securities on their numbers instead - profitability, valuation, momentum, ... - use screenSecurities. A result carries the identity of the security only: id, ticker, isin, name, assetClass and currency. Add 'fields' to get more - DESCRIPTION for the prose describing the company or the fund, PERFORMANCE for the metrics and the scores - and expect a much larger response. Optional 'assetClass' filter: STOCK, ETF, FOREX. Optional 'size' (default 10, max 50) caps the number of results.
startBacktest
ChatGPTStart a backtest of the draft of a strategy of the authenticated user, over a date range. The start date is moved forward automatically when quotes are not available for the whole range. 'inflowRules' is how money enters the strategy over the period; optional 'outflowRules' is how it is withdrawn, null for no withdrawal. The benchmark is read from the definition of the strategy. Pre-built strategies cannot be backtested directly: copy one with createStrategy, passing back the definition read with listPreBuiltStrategies, and backtest the copy. Backtests run asynchronously: this tool returns a backtest with the PENDING status, then poll listBacktests with type USER and the returned backtestId until the status is COMPLETED or FAILED.
startOnboarding
ChatGPTGuided introduction to Investminder for a new user: presents the product and walks them through their first steps. Call it when the user greets you, asks what Investminder can do or how to get started, or when another tool reports that no account exists, then offer the onboarding to the user. It is optional: if the user declines or asks something else, answer that directly. Works without an account. Returns the onboarding script to follow, step by step, adapted to what the user has already done.
updateStrategy
ChatGPTUpdate the draft of a strategy of the authenticated user: its definition and its constraints, both documented in the schema. The constraints are optional for a PROGRESSIVE or RANKED strategy and required with the asset classes of its allocations for a REBALANCED one. The definition replaces the previous one entirely, so send the complete definition on every call. A strategy that has been published has no draft anymore: call createStrategy with its strategyId to start a new one.
upsertUser
ChatGPTCreate the Investminder user and account of the authenticated identity, the one every other tool is scoped to, or update it. Call it when another tool reports that no account exists yet, or during the onboarding (startOnboarding). Creating requires 'country', 'currency' and 'language'; updating changes only the fields passed. Ask the user for their country and their currency instead of guessing - propose what fits the conversation and let them confirm; both are theirs to decide. 'country' is the ISO 3166-1 alpha-2 code of the country they live in. 'currency' is what they hold money in, not what they are billed in: subscriptions are charged in USD or EUR whatever this says. 'language' is the language of the conversation, and is what the emails of the account are sent in. Optional 'onboarding' holds the answers of the onboarding quiz. The response carries 'created', the saved 'onboarding' and 'recommendedStrategies', the pre-built strategies fitting the answers; the onboarding says what to do with them. Once it returns, every other tool works for this user.
addPortfolioCash
ClaudeaddPortfolioPosition
ClaudeanalyzeSecurities
ClaudeconnectPortfolio
ClaudecreatePortfolio
ClaudecreateStrategy
ClaudecreateUser
ClaudedeleteStrategy
ClaudegetCorrelationMatrix
ClaudelinkPortfolioStrategy
ClaudelistBacktests
ClaudelistInstitutions
ClaudelistPortfolioTransactions
ClaudelistPortfolios
ClaudelistPreBuiltStrategies
ClaudelistScreeners
ClaudelistUserStrategies
ClaudepublishStrategy
ClaudescreenSecurities
ClaudesearchSecurities
ClaudestartBacktest
ClaudestartOnboarding
ClaudeupdateStrategy
ClaudeupsertUser
Claude