Skip to content

Transactions and values

Transactions explain changes. Valuations establish absolute values. Use the event that best matches what happened rather than forcing every change into a deposit or withdrawal.

Transaction types

TypeEffectTypical use
DepositIncreaseContribution or cash received
WithdrawalDecreaseCash removed from the account
InterestIncreaseInterest credited
DividendIncreaseDividend received
Capital gainIncreaseRecorded gain
Capital lossDecreaseRecorded loss
FeeDecreaseManagement, bank, or trading fee
PurchaseIncreaseIncrease a tracked holding
SaleDecreaseReduce a tracked holding
Manual adjustmentSignedExplicit correction or uncategorized change
Liability paymentDecrease debtPayment against an amount owed
Liability increaseIncrease debtAdditional borrowing or accrued debt

Opening balances and transfers use dedicated workflows.

Position accounts use different source events

Generic Purchase, Sale, Capital gain, and Capital loss are monetary balance-account types. A position account rejects them. Use its Buy, Sell, cash, price, and investment-action workflows instead.

Position cash and settlement

Position accounts keep an account-currency cash subledger alongside instrument units.

Source eventCash effectQuantity effect
Deposit / withdrawalAdds or removes external broker cashNone
Interest / cash dividendAdds income cashNone
FeeRemoves cashNone
BuyRemoves settlement plus feesAdds units
SellAdds proceeds less feesRemoves units
Dividend reinvestmentAdds dividend cash and consumes it in grouped buysAdds purchased units
In-kind transferOptional grouped fee onlyPaired transfer-out and transfer-in

Position buy with execution, fee, trade, and settlement fields

Buys and sells are internal allocation changes, not contributions or withdrawals. Cross-currency trades require the actual account-currency settlement or explicit applied settlement rate. A grouped reinvestment saves and deletes its dividend and buys atomically.

See Position-tracked investments for corporate actions, reconciliation, conversion, and price behavior.

Record a transaction

  1. Open an account and select a quick action, or open Transactions and select Add transaction.
  2. Choose the account and type.
  3. Enter a positive amount except for a signed manual adjustment.
  4. Choose the financial date.
  5. Add a description, optional stable external ID, and private notes.
  6. Save and verify the account balance.

Search and audit history

The transaction workbench combines literal text search with account, type, date, direction, and sort filters. Filters work together and remain in the URL, so a filtered view can be bookmarked or refreshed.

Transaction workbench with owner-scoped search and filters

The CSV download uses the same filters as the current view.

Update an asset value

Use Value for a point-in-time observation such as:

  • current property appraisal;
  • vehicle market value;
  • business valuation;
  • statement balance for a manually tracked fund.

The valuation resets the account balance on that date. It does not count as a deposit, contribution, income item, or transfer.

Transfer between accounts

Choose Transfer, then select two active accounts. For the same currency, enter one amount. For different currencies, also enter the destination amount.

The paired records are committed together. Deleting a transfer removes both sides together and replays both balances.

Import detailed account history

Start from the target account and select Import. Wealthboard accepts:

  • CSV columns exactly external_id,type,amount,date,description,notes;
  • JSON using the Account History Import v1 envelope;
  • up to 5 MB and 10,000 rows.

Preview does not write anything. It shows the selected account, date range, current balance, projected balance, and each row outcome. On confirmation the browser resends the file and its SHA-256 hash; Wealthboard reparses it and commits the valid subset atomically.

Stable external IDs matter

Reimporting an identical external ID is safely skipped. Reusing an existing ID with different fields is a conflict and never overwrites the stored record. Do not use changing spreadsheet row numbers as IDs.

Opening balances and transfers cannot be imported through this format.

Private wealth tracking, on infrastructure you control.