Concept: Portfolio and Position

Position

A position is the state of one instrument (for example BTC or ETH) at a given time.

Core position values include:

Total quantity held
Average acquisition price
Cost basis
Market value
ROI
Unrealized gains/losses (UGL)
Realized gains/losses (RGL)
Weight in portfolio

Portfolio

A portfolio snapshot aggregates all user positions at a timestamp.

Core portfolio values include:

Total market value
Cost basis
Unrealized PnL (UPL)
ROI
Number of transactions included
Instrument distribution (top instruments + Others)
Category distribution (Bitcoin, Stable, Memes, DeFi, Other)

Position distribution by connexion

For one instrument, Glacez can show distribution across connexions (exchange accounts and wallets). This helps users answer: "Where exactly is this asset currently held?"

Coherence checks

Before certain transaction operations, Glacez validates portfolio coherence:

Add operation
Update operation
Delete operation

If an operation would create an impossible state (for example negative holdings), it is rejected with coherence details.