Assets & Securities
Add and manage securities, prices, classifications, logos, property, and other assets in Wealthfolio.
Last updated
An asset describes what you own. A holding records how much of it you own in an account. The same security can appear in several accounts and share one name, logo, price history, and set of classifications.
Use Settings → Securities to manage investment assets. Open a holding to see its asset page, prices, account holdings, and available history. Property and other assets use a separate workflow under Holdings → Add Asset.
Choose the right type
| Type | Use it for | How you track its value |
|---|---|---|
| Equity | Stocks, ETFs, and mutual funds | Units held and a price per unit. Funds share the Equity type; their more specific label belongs in Classification. |
| Crypto | Cryptocurrency | Coin or token quantity and a price in the selected quote currency. |
| Bond | Bonds and Treasury securities | Quantity and price, with optional bond details and a multiplier. Check the price convention below. |
| Option | Option contracts | Contract quantity, price, and contract multiplier. |
| Metal | A metal instrument tracked like a security | Quantity and price per unit. This is separate from a Precious Metal entry under Add Asset. |
| FX | Currency pairs used for exchange rates | An exchange rate, rather than an investment balance. FX entries are managed separately from the Securities list. |
| Property, Vehicle, Collectible, Precious Metal, or Other | A home, car, physical gold, or another item you value yourself | A dated total value that you update manually. |
| Liability | A mortgage, loan, or other debt | The amount still owed, entered as a positive value and counted against net worth. |
The app’s data format also includes Private Equity, but it is not a separate choice in the current Add Asset form. Use the available workflow that matches what you need to track, such as Other for a manually valued investment.
Asset type and classification have different jobs. The type on the General tab controls how the app handles the instrument, including its default multiplier. Classification labels organize reports. Giving a fund a Bond classification does not change its pricing rules.
Add a security
- Open Settings → Securities → Add Security.
- Search for the name or ticker and select the correct listing. Check the exchange and currency, especially when the same company trades in several countries.
- Review the symbol, name, type, currency, and quote mode. Add an exchange or notes if needed.
- Save the security.
You can also enter the details yourself when search does not find it. Choose Manual pricing if no provider has a suitable quote. Selecting a market search result fills in details and normally enables automatic pricing, but you should still check the result.
Creating a security alone does not add units, spend cash, or create a purchase. Record an activity or add a holding in a holdings-based account to record ownership. Imports can also create or match assets; check their asset review step before confirming an import.
Edit a security
Use the security’s menu to choose Edit, or open its asset page and edit from there. The editor has General, Classification, and Market Data tabs.
Changes to the shared asset affect every account using it. They do not create an activity or change how many units you own.
General fields
| Field | Meaning and effect |
|---|---|
| Symbol | The security’s displayed ticker. You choose it at creation; it is read-only in the editor. A provider’s different ticker belongs in Symbol Mapping. |
| Name | The name shown in the app. Editing it changes the label, not the holding or price. |
| Currency | The currency in which the security’s prices are quoted. It can differ from the account and activity currencies. Changing it is not a currency conversion of your purchases or existing price history. |
| Asset Type | Equity, Crypto, Bond, Option, or Metal for investment assets. It also sets the default multiplier. Use Classification for labels such as ETF or mutual fund. |
| Exchange | The listing’s exchange. The app stores its market identifier code, or MIC. This helps providers find the correct listing. |
| ISIN | An international identifier for the security. Useful for identifying a listing; it does not replace provider symbol settings. |
| Notes | Your own notes about the asset. They do not change calculations. |
| Contract Multiplier | Scales quantity × price for contract value and trade calculations. Leave it empty to use the standard value: 100 for options and 1 for other types. An override must be greater than zero. |
| Maturity Date | For bonds, the date the bond matures. Some bond pricing methods use this. |
| Coupon Rate | For bonds, the annual coupon as a percentage. Enter 4.375 for 4.375%, or 0 for a zero-coupon bond. This does not create interest activities. |
| Coupon Frequency | For bonds, Annual, Semi-Annual, Quarterly, or Zero Coupon. Used by supported bond pricing methods. |
Save General or Market Data changes with Save changes. Classification and logo changes have their own save behavior, explained below.
Check multipliers and bond prices
For a standard option, 2 contracts priced at $3 with a multiplier of 100 have a value of $600 before charges. A nonstandard contract may need a different multiplier. Check its contract details before changing this field.
Bond prices need special care. Wealthfolio’s bond providers use prices as a fraction of face value, so a bond quoted at 98% may have a stored price of 0.98. Bonds normally use a multiplier of 1. If you manually enter 98 instead, you must use a matching quantity and multiplier convention. Do not apply a second percentage adjustment to an already normalized provider price.
A multiplier can change valuations and the trade totals the app calculates. An activity’s saved final cash amount remains its cash total. See Activity Fields before changing historical trade details.
Currency and listing corrections
If a price looks wrong, check the currency and exchange before changing the number. Some listings quote in minor units, such as GBp for pence rather than GBP for pounds.
Changing an exchange or quote currency may change future price lookups. Review existing prices afterward; editing the asset is not a request to convert all old quotes. See Market Data & FX for how quote, activity, account, and portfolio currencies work together.
The editor does not offer a general ticker rename or a way to turn an investment into property or a liability. For a wrong asset on a transaction, correct the activity’s asset selection. For a provider using a different ticker, use Symbol Mapping.
Manage prices
Open Edit → Market Data to see the latest price, its date, and its source.
- Automatic Updates on: the app requests prices from market data providers.
- Automatic Updates off: you manage prices manually. Turning this off does not remove the existing history.
- Preferred Provider: choose Auto to let the app select a provider, or choose a provider for this asset.
- Symbol Mapping: give each provider the symbol it expects. For example, CoinGecko may need
bitcoinwhile another provider uses a ticker pair.
Symbol mappings change how the app looks up a price, not the security’s displayed symbol. The editor checks mappings and warns about a failed check, but it still allows saving. A saved mapping is therefore not a guarantee that prices will be available.
You can select a configured custom provider when the built-in providers do not cover a listing. Provider availability and coverage depend on your settings and the instrument.
Price history
Open the asset’s price history to inspect dates and prices. In manual mode, you can add, edit, and delete price entries. These are prices per unit or contract under the asset’s price convention, not the total value of your account holding.
The price table includes these fields:
| Field | Meaning |
|---|---|
| Date | When the quote applies. This places it in the price history. |
| Open | The price at the start of the trading period. |
| High / Low | The highest and lowest prices during that period. |
| Close | The closing price used in the asset’s price chart and valuations. |
| Volume | The amount traded during that period. It is not your holding quantity. |
Update quotes requests an update. Refresh history replaces provider quotes with newly fetched data after confirmation. It preserves manual quotes. Check the history after switching providers or correcting a symbol mapping, since a new provider may have different coverage.
Prices affect market values and historical charts. They do not replace your recorded purchase prices or final cash totals.
Classify your assets
Open Edit → Classification to organize an asset by instrument type, asset class, industry, region, risk category, or custom group. Manage the available categories under Settings → Classifications.
Some classifications allow one choice, such as Instrument Type and Risk Category. Others allow several categories with percentage weights. A fund might have 60% North America and 40% Europe, for example.
For weighted exposure categories, check that the total matches your intention, usually 100%. The editor displays the total and lets you change each weight. These weights describe the asset’s exposure; they do not divide or move your actual units. Custom groups can also be used as personal labels.
Classification changes save when you choose a category, add or remove an assignment, or finish editing a weight. Closing the editor or cancelling General changes does not undo those saved assignments.
Classifications feed allocation views and reports. They do not change cash, cost basis, security prices, or create trades. For portfolio targets, see Allocation Targets.
Change a logo
- Open the security editor and select its logo, or use the editable logo on its asset page.
- Choose an image or drag one into the logo dialog.
- Check the previews, then select Save logo.
Supported files are PNG, JPEG, WebP, and SVG, up to 10 MB. The app fits the image into a square, keeps its proportions, and converts it to a small PNG. If it cannot reduce a detailed image enough, choose a simpler image. Prepare any crop before uploading; the dialog previews the result rather than providing a crop editor.
Use Reset to default to remove the custom image and return to the app’s default logo or fallback. Logo changes save separately from the General form and affect the shared asset wherever it appears. They do not affect prices or calculations.
Add and manage property and other assets
Open Holdings → Add Asset and choose Property, Vehicle, Collectible, Precious Metal, Liability, or Other. Enter a name, currency, current value, and value date. Add the purchase or loan details offered by the form if you have them.
These entries use dated manual valuations. They do not create an investment account, buy/sell activity, or cash withdrawal.
Enter the total current value of the item. For precious metals, quantity and weight unit describe what you own; the current value is still the total value, not a price per gram or ounce. A Metal security is the separate choice for quantity-based investment pricing.
Choose the currency carefully at creation. The alternative asset details editor does not offer a currency or main asset-type change.
Details and metadata
Open the asset and choose its edit action to manage its details. Available fields depend on the type:
| Asset | Additional details |
|---|---|
| Property | Address and property type: Residence, Rental Property, Land, or Commercial. You can also manage linked liabilities. |
| Vehicle | Vehicle type, such as Car, Motorcycle, Boat, or RV, and a description. |
| Collectible | Type, such as Art, Wine, Watch, Jewelry, or Memorabilia, and a description. |
| Precious Metal | Gold, Silver, Platinum, or Palladium; quantity; unit in troy ounces, grams, or kilograms; description; and purchase price per unit in the details editor. |
| Liability | Liability type, original amount, origination date, interest rate, and a linked asset. |
| Other | Description. |
The details editor also offers a name, notes, and relevant purchase fields. Much of this extra information is stored as metadata, meaning details attached to the asset. You edit the named fields in the form; there is no need to edit raw metadata.
After clearing an optional detail such as an address or description, reopen the editor to check it. Some fields currently keep their previous value when saved blank.
Descriptions and notes are for your records. A liability’s interest rate does not automatically add interest or schedule payments. Metal quantities do not automatically fetch metal prices or update the total valuation.
Purchase details can also add a dated starting value to the history when a purchase price and date are supplied. When creating an asset, a supplied purchase date must be earlier than the current value date. Inspect the value history after changing purchase details, especially a date; older entries may still need a separate correction.
Update values and debts
Use Update Valuation to record a new total value and date. Use the value history to correct or remove individual entries. Editing a description, quantity, or purchase detail is not a substitute for updating the current valuation.
For a liability, enter the positive balance still owed. Record a lower value after repayments, or zero when paid off. Linking a mortgage or other liability to an asset helps show the relationship; it does not automatically change either value or record a payment. Update the property value and debt balance separately.
A property can have linked liabilities. You can link or unlink them from its details, or choose a linked asset in the liability’s details. Unlinking does not delete the debt.
Delete an alternative asset
Use the asset’s delete action and confirm. This removes the asset and its valuation history. Deleting an asset that has linked liabilities leaves those liabilities in place and removes their link.
If the item was sold or a debt was paid off, consider recording a zero valuation instead so that its earlier values remain in your history.
Delete a security
Open the security’s menu in Settings → Securities, choose Delete, and confirm. Deletion also removes its saved quotes.
The app blocks deletion if any activities still reference the security, including old transactions. A zero current holding does not make it safe to delete: its history may still be needed for past balances and returns. Keep securities used in historical activities or saved holdings. Do not delete valid transactions simply to tidy the list.
Use the Securities list’s Current/Past, pricing mode, and market data filters to narrow the view instead. FX entries and alternative assets are shown through their own workflows. Expired options are also filtered out of the Securities list, so their absence there does not mean their history was deleted.
What is stored behind the scenes?
An asset has an internal ID that connects it to activities, holdings, quotes, and classifications. A symbol or name is a display and lookup detail, not that ID.
Besides the visible fields, imports and providers may attach identifiers, provider mappings, and structured contract details. For options, these can include the underlying asset, expiration, call/put side, strike, multiplier, and option symbol. These are not all editable in the General form. Bonds can also carry additional identifiers or face-value information beyond the fields shown there.
Classification assignments and custom logos are managed separately from those metadata fields. Use their controls instead of trying to put labels or image links into Notes. Developers working with asset records can find the technical structure in the addon asset reference.