archive_holdings
ChatGPTArchives holdings the user sold: each gets a position of 0 today and is archived, so its history stays in net worth.
archive_portfolio
ChatGPTArchives a portfolio the user closed: each holding in it is recorded as sold today and archived, so its history stays in net worth.
create_holdings
ChatGPTCreates holdings with their dated positions, such as the lines of a statement. Check list_holdings with includeArchived true first: an archived copy still counts toward value, so adding it again doubles it.
create_portfolio
ChatGPTCreates an empty portfolio. To add holdings to one the user already has, use its id from get_portfolio_overview instead.
delete_holdings
ChatGPTDeletes holdings created by mistake, taking them out of net worth history. For a sale, use archive_holdings.
delete_portfolio
ChatGPTDeletes a portfolio created by mistake, with its holdings; both leave net worth history. For an account the user closed, use archive_portfolio.
get_allocation
ChatGPTGets what the portfolio is made of, grouped by sector, region, asset type and currency at once. Use it for concentration and exposure questions — "am I too heavy in tech", "how much of me is in North America", "how much is in cash" - cash is its own Cash asset type, separate from Bonds (CDs and treasuries count as Bonds), though a bank account lands there only if the user classified it so or its name mentions cash, savings or a money market; otherwise it goes by whatever its name suggests, usually Unknown. A holding can be split across buckets, so a global fund counts partly in several regions rather than landing in one. Read portfolios and selection to see what the answer covered. Each holding is classified by what the user said about it, then by what the catalog knows, then by a guess from its name, so "Unknown" means nothing was known rather than nothing was held. totalValue is the positive value classified across the portfolios it covers, including ones kept out of net worth, so it is not net worth. Check isComplete before quoting shares. Needs a TrackMyStack subscription; without one this returns an error. get_portfolio_overview and list_holdings still work, priced at the last close, as do search_market, get_holding_history and every tool that creates, updates, archives, unarchives, deletes or restores a portfolio or holdings.
get_dividend_income
ChatGPTGets dividend income received over a period, payments already declared for the future, and what each holding yields. Use it for "how much did I get in dividends last year", "what is my yield" and "what is coming up". The period defaults to the last twelve months and is always compared against the same number of months immediately before it - or days, when the period is not whole months, so year-to-date reads against the days just before it rather than the same months last year - and a year reads against the year before. Income counts a payment on the day it was paid, converted at that day's rate; upcoming payments are expected rather than received. Yield is always the trailing twelve months over today's value, whatever period is asked for. A holding whose dividends are unknown is left out of it rather than counted as paying nothing, so compare measuredMarketValue against totalMarketValue before calling the figure the portfolio's yield: the part left out could yield more or less. A null yield means unknown, never nothing. Read portfolios and selection to see what the answer covered. Amounts are whole positions, so scale by a portfolio's ownership before reconciling with get_portfolio_overview. Crypto and manually tracked holdings are not covered here at all. Check isComplete before presenting a total as final. Needs a TrackMyStack subscription; without one this returns an error. get_portfolio_overview and list_holdings still work, priced at the last close, as do search_market, get_holding_history and every tool that creates, updates, archives, unarchives, deletes or restores a portfolio or holdings.
get_holding_history
ChatGPTGets the dated positions of one holding, newest first. Use it to answer what was held when, and always before writing a position dated earlier than an existing one: cost basis is computed from the difference between consecutive positions, so inserting one changes what the position after it means. Each entry's quantityChange shows that difference. Results are paginated; use nextOffset while hasMore is true.
get_movers
ChatGPTGets the holdings with the largest absolute value changes since the previous UTC close, either across net-worth portfolios or within one portfolio. Price change is returned in percentage points and value change always carries its valuation currency. Check isComplete and warnings before presenting the list as the largest movers. Needs a TrackMyStack subscription; without one this returns an error. get_portfolio_overview and list_holdings still work, priced at the last close, as do search_market, get_holding_history and every tool that creates, updates, archives, unarchives, deletes or restores a portfolio or holdings.
get_net_worth_history
ChatGPTGets what the account, or one portfolio, was worth over a period and the change across it. The change is in what the account is worth, including money paid in or taken out; it is not an investment return, so say so when the user asks how they are doing. Ask for "endpoints" when only the change matters and a denser granularity when the shape does. Values are end-of-day closes, except a final point dated today, which is priced live and flagged with isLive. Check isComplete before narrating the shape: a point that left a holding out may understate, and a sharp move at such a point is not a real move. Needs a TrackMyStack subscription; without one this returns an error. get_portfolio_overview and list_holdings still work, priced at the last close, as do search_market, get_holding_history and every tool that creates, updates, archives, unarchives, deletes or restores a portfolio or holdings.
get_portfolio_overview
ChatGPTGets the user's current net worth, the change since yesterday's close, and a per-portfolio breakdown. Every amount carries its currency. Check isComplete: when it is false some holdings could not be valued and the totals exclude them — say so rather than presenting the figure as final. The breakdown also lists portfolios the user has kept out of their net worth, named in portfoliosExcludedFromNetWorth and flagged per portfolio by includedInNetWorth, so the values listed do not necessarily add up to the total. Works without a subscription, in which case net worth is priced at the last market close and today's change is withheld: report todayChangeUnavailableReason rather than telling the user nothing moved.
list_goals
ChatGPTGets the user's savings goals with what each one is worth today and where it lands on its target date. Use it for "am I going to make it" questions rather than valuing the linked portfolios yourself: a portfolio can be split across several goals, and only the allocated share of it counts here. status is decided by the projection, not by progress so far, so a goal at 10% with years left can still be on track - and a goal already past its target date has daysRemaining 0 without status saying so. The projection assumes the contributions keep coming and the return holds; it is arithmetic, not a forecast, so do not present it as what will happen. Check isComplete and the top-level warnings, which cover pricing the linked portfolios, then each goal's own warnings, before quoting its figures. Needs a TrackMyStack subscription; without one this returns an error. get_portfolio_overview and list_holdings still work, priced at the last close, as do search_market, get_holding_history and every tool that creates, updates, archives, unarchives, deletes or restores a portfolio or holdings.
list_holdings
ChatGPTLists the user's current holdings grouped by portfolio, optionally only some portfolios or some holdings. Values, cost basis and unrealised gain carry explicit currencies; percentage fields are in percentage points. Each figure is the whole position, so scale by the portfolio's ownershipPercent before reconciling with get_portfolio_overview. By default each holding carries what answering a question needs: its home-currency figures only when it is tracked in another currency, and its gross quantity and debt only when it carries debt. Pass detailed true before updating a holding with update_holdings: only then does a holding carry its revision, the currencies a price and a fee are recorded in, its price quote and its classification. Check each holding's warnings and the top-level isComplete flag before presenting valuations as final. Results are paginated by holding; use nextOffset while hasMore is true. Works without a subscription, in which case every price is the last market close rather than real time - priceLatency says which.
restore_holdings
ChatGPTRestores deleted holdings. Without the id from the delete, the user can restore it from the app's "Recently deleted" screen.
restore_portfolio
ChatGPTRestores a deleted portfolio. Without the id from the delete, the user can restore it from the app's "Recently deleted" screen.
search_market
ChatGPTSearches TrackMyStack's supported market catalog and returns bounded candidates; it never chooses an asset automatically. Use this before any market-linked holding write and ask the user to choose when more than one candidate plausibly matches. A candidate's assetId is what create_holdings takes; its fullTicker is the current symbol, which a venue can reassign.
unarchive_holdings
ChatGPTUnarchives holdings, leaving their positions as they are.
unarchive_portfolio
ChatGPTUnarchives a portfolio so it takes new holdings again.
update_holdings
ChatGPTWrites or removes dated positions on holdings, or changes how their cost basis is tracked.
update_portfolio
ChatGPTChanges a portfolio's settings; anything omitted stays as it is.