Depotticker Help
Everything the app can do, in the order you will probably need it.
- Getting started
- Portfolios and positions
- How the numbers are calculated
- Charts
- The overview page
- Import and export
- Menu bar
- Widgets
- Privacy and screen sharing
- iCloud sync
- AI agents (MCP)
- Updates
- Troubleshooting
Getting started
- Open Depotticker. Choose the … button next to the portfolio chips and pick New Portfolio…, for example one per broker.
- Click + (or press
⌘N), search for a share or fund by name, symbol or ISIN, and enter how many you hold and your average purchase price per share in euros. - Have many positions? Use import from CSV instead.
Portfolios and positions
- Switch portfolio: use the chips at the top of the sidebar. All combines everything; a share held in several portfolios appears once with the combined quantity.
- Edit or remove a position: right-click it (or swipe left on it with two fingers), or use the pencil next to the broker on the stock page.
- Rename or delete a portfolio: select it, then use the … button.
- Sort: the button at the bottom right of the sidebar sorts by position value (the default), name, today's change or total gain.
- Coloured pill: click it to switch between today's change in %, today's change in €, total gain in % and total gain in €.
How the numbers are calculated
| Figure | Meaning |
|---|---|
| Value | Quantity × latest regular-session price, converted to euros at the current exchange rate. |
| Today | Value now minus value at the previous close, each at its own exchange rate, so the day's currency move is included. |
| Total gain | Value minus what you paid (quantity × your average cost in euros). |
Prices are those of the listing you added, for example the US listing for AAPL. After the market closes the official closing price is used. Pre-market and after-hours prices are shown on the stock page for information but never enter your values. Your broker may value the same share at the price of a different exchange, so small differences are normal.
Charts
- Period: click a period, or pinch on the trackpad or screen to move to a shorter or longer one.
- Inspect: move the pointer over the chart to see the price at that moment.
- Measure: drag across the chart to see the change between two points.
- Indicators: the Indicators button turns trading volume, a 20-point moving average, the period's high and low, your average cost and trading-day separators on or off.
- Market status: the badge next to the exchange shows whether the market is open and when it opens or closes.
The overview page
Click the total at the top of the sidebar (or press ⌘0) to see the portfolio as a whole: a value chart, today's change, total gain, the split across portfolios, the largest positions as a ring chart, and today's biggest gainers and losers.
The value chart shows how today's holdings would have developed over the chosen period at today's exchange rates. It is not a record of your actual purchases, because the app does not know when you bought.
Import and export
Use the import and export button in the toolbar.
- Export as CSV… saves all positions with current price, value and gain. The file opens in Excel and Numbers.
- Open Import Template opens an example file you can fill in.
- Import from CSV… reads a file with these columns:
Portfolio,Symbol,Name,Quantity,Average cost,Currency. Only Symbol and Quantity are required; the currency is the one you paid in and defaults to EUR, and an empty average cost means the purchase price is unknown. You then choose whether to add or update the positions, or replace everything. A symbol already held in the portfolio of the same name is updated, not duplicated. A backup of the previous state is kept in the app's data folder. - Raymond James: the file from Client Access › Portfolio › Value › Export Data is recognised automatically. Its positions go into a portfolio named “Raymond James” with costs in US dollars. Positions for which Raymond James shows no amount invested are imported with an unknown purchase price: they count towards your value, but not towards gain and invested.
- Several brokers and currencies: the same share can sit in several portfolios; its page lists each one. Costs stay in the currency you paid in. Totals are shown in euros, converting foreign costs at today's exchange rate, so the gain equals your broker's gain converted to euros.
- Several purchases in a file: add the optional columns
DateandType(Buy or Sell) and write one row per purchase or sale; in such a row Quantity is the number of shares bought or sold and Average cost is the price paid or received. Rows for the same portfolio and symbol become one position. Dates can be written as 2026-03-31 or 31.03.2026. The template shows an example, and the export writes the same layout. - Estimating purchase dates: most brokers only report an average price. Estimate Missing Purchase Dates (same menu, also offered when importing) gives each purchase without a date the most recent day the share closed at your price, converted into the currency you paid in. For Raymond James the “Time Held” column narrows the search. Choose Yearly Purchases over the Years if you bought repeatedly: the app then assumes equal purchases once a year, going back as few years as it takes for the market prices to explain your average. These entries are marked as estimated and change no quantity or cost. It is a guess: a position built up over several purchases was partly bought earlier, so correct the entries where you know the real dates.
- Purchases and sales: edit a position (pencil on the share's page) to record a purchase or sale with date and price. Shares and average cost are then calculated from these entries (a sale leaves the average cost of the remaining shares unchanged), and the realised gain is shown.
Symbols are Yahoo Finance symbols, such as AAPL, SAP.DE or VWCE.DE. Both comma and semicolon separated files are understood, as are numbers written as 1.234,56 or 1,234.56.
Menu bar (Mac)
The menu bar item shows today's change in percent by default. In Settings › Menu bar you can switch to an icon only, the change in euros, both, or the total value. Click the item for a summary of each portfolio and the day's biggest moves.
Widgets
On the Mac, right-click the desktop, choose Edit Widgets and search for Depotticker. On iPhone and iPad, touch and hold the Home Screen and tap Edit. There are three sizes: small (value and today's change), medium (plus each portfolio) and large (plus the biggest moves). The system decides how often widgets refresh, usually every 15 to 30 minutes.
Privacy and screen sharing
- Hide amounts automatically: while a call is in progress, the Mac is being viewed through Screen Sharing or the display is mirrored, the menu bar shows only percentages. On iPhone and iPad the totals are hidden while the screen is recorded or mirrored.
- Keep windows out of recordings: Depotticker asks macOS to leave its windows out of shared and recorded screens. Some capture tools ignore this request, so treat it as an extra layer rather than a guarantee.
Both options are in Settings › Privacy.
iCloud sync
In the App Store versions, your portfolios are stored in your Apple Account and appear automatically on your Mac, iPhone and iPad. Nothing is saved as a file in iCloud Drive, and there is nothing to set up beyond being signed in to iCloud. The direct-download Mac version keeps its data on that Mac.
AI agents (MCP)
The Mac app includes a Model Context Protocol server, so an AI assistant can read your portfolio and change positions when you ask it to. It runs only while the assistant uses it and talks to nothing but the assistant that started it.
For Claude Code:
claude mcp add depotticker -- /Applications/Depotticker.app/Contents/MacOS/Depotticker --mcp
For other assistants, add a server with the command /Applications/Depotticker.app/Contents/MacOS/Depotticker and the argument --mcp.
| Tool | What it does |
|---|---|
list_portfolios | Portfolios with their positions, quantities and average cost. |
get_valuation | Live value, today's change and gain per position and in total. |
search_symbols | Finds the symbol for a company, fund or ISIN. |
create_portfolio | Adds an empty portfolio. |
add_transaction | Record a purchase or sale with date and price. |
add_position, update_position, remove_position | Change your positions. The open app shows the change within about 20 seconds. |
Updates
The direct-download Mac version checks for updates automatically and offers to install them. Choose Depotticker › Check for Updates… to check now. App Store versions are updated by the App Store.
Troubleshooting
- A position shows “—”: the symbol has no price yet. Check the symbol by searching for it again.
- Prices do not update: the status line at the bottom of the sidebar shows the last update or an error. The data source occasionally limits requests; the app retries by itself.
- Values differ from my broker: see how the numbers are calculated.