Skip to content

๐Ÿ”„ Asset Transfer

Transaction Form โ€” TRANSFER

Asset transfers move securities between broker accounts without a sale. The position leaves one broker and arrives at another โ€” no cash changes hands, and in most jurisdictions this is not a taxable event.


๐Ÿ”‘ Key Properties

Property From (source) To (destination)
Code TRANSFER TRANSFER
Cash effect โ€” โ€”
Asset effect โฌ‡๏ธ Decreases โฌ†๏ธ Increases
Broker Source broker Destination broker
Tax event Varies by jurisdiction Varies

๐Ÿ“Š How It Works

An asset transfer records two entries: one debit at the source broker and one credit at the destination broker. Both reference the same asset with mirrored quantities.

Common scenarios:

  • Moving shares from one broker to another
  • Inheriting assets
  • In-kind contributions to a different account type (e.g., ISA, 401k)

Cost Basis Preservation

When transferring assets, the original cost basis should be preserved. The transfer itself is not a taxable event in most jurisdictions (though rules vary). LibreFolio allows an optional cost basis override on the receiving side.

See ๐Ÿ“Š Weighted Average Cost (WAC) for how the automatic cost basis is computed.


๐Ÿ”€ Relationship with Adjustments

A Transfer is stored as two TRANSFER rows, one per broker, each linked to the other through related_transaction_id. Splitting the pair turns the two rows into independent ADJUSTMENTs, and promoting two Adjustments turns them back into a Transfer:

Operation Result
Split (unlink) Transfer โ†’ two independent Adjustments
Promote (link) Two Adjustments โ†’ Transfer

Promote constraints: same asset, different brokers, opposite quantities, and neither row linked to an asset event (a split, for instance), since a transfer cannot carry that link.


๐Ÿ‘ต Succession and Untracked Source Brokers

A true TRANSFER needs two brokers in LibreFolio: source and destination. If the source dossier is outside LibreFolio, the incoming leg is better modeled as a positive cashless ADJUSTMENT with a per-unit cost_basis_override, not as a paired transfer. Crรฉdit Agricole succession rows (GIRO ALTRO DOSSIER, VERS.TITOLI) use this pattern: the inherited securities enter as in-kind capital, no cash DEPOSIT is created, and the origin causale remains in the description for auditability.