Source: https://wealthfolio.app/docs/concepts/

# Core Concepts

Objects Wealthfolio uses under the hood.

* * *

Last updated September 10, 2026

## Account

| Field | Purpose |
| --- | --- |
| **Name** | Display label (2–50 characters) |
| **Group** | Collapses similar accounts on the dashboard (e.g. _RRSP_) |
| **Type** | _Securities · Cash · Credit Card · Crypto_ |
| **Currency** | The account’s currency; set at creation, converted to your base currency for totals |
| **Tracking mode** | _Transactions_ (record every activity) or _Holdings_ (snapshots) |
| **Status** | _Active_, _Hidden_ (stays in totals), or _Archived_ (removed, restorable) |

## Activity

All portfolio changes resolve into one of these actions.

| Type | Cash Δ | Holdings Δ | Notes |
| --- | --- | --- | --- |
| **BUY** | − | + | Fee optional |
| **SELL** | + | − | Gain tracked |
| **DIVIDEND** | + | 0 | Cash income |
| **INTEREST** | + | 0 | Cash income |
| **DEPOSIT / WITHDRAWAL** | ± | 0 | Cash only |
| **TRANSFER\_IN / OUT** | ± | ± | Internal keeps cost basis; External seeds/removes positions (opening balances, gifts, write-offs) |
| **FEE / TAX** | − | 0 | Stand-alone charges |
| **SPLIT** | 0 | qty/price adjust | No value change |

Cash legs post to the synthetic symbol `$CASH-<CCY>` automatically. The saved amount is the final cash paid or received, including fees and taxes. See [Activity Fields](https://wealthfolio.app/docs/concepts/activity-fields/) for field meanings and special cases.

## Symbol lookup

1.  Exact ticker (`AAPL`, `BTC-USD`).
2.  Ticker + suffix (`RY.TO`).
3.  First Yahoo Finance hit.

Need to override? Use the **Universal Symbol ID**.

## FX rates

-   Pulled every 6 h from the default market data provider.
-   View/edit: `Settings → General → Exchange Rates`.
-   Manual rates override auto values until you change them again.

* * *