Coffer Docs
For Liquidity Providers

Tracking Pool Activity

Read your pool share, asset exposure, and activity metrics

Track the assets the pool actually owns, your LP token share, and the trades and fees changing that basket. Virtual liquidity measures pricing depth; it is not extra capital you can withdraw.

What the main numbers mean

MetricMeaningLimit
TVLUSD value of LP-owned actual reservesDepends on external prices
Virtual TVLUSD valuation of virtual balancesNot withdrawable capital
VolumeTraded value over a time windowNot LP income
Displayed APYAnnualized recent LP fee incomeNot a forecast or total return
LP token shareYour LP tokens divided by supplyThe underlying basket changes

Indexing, RPC responses, and prices can lag. A missing token price contributes zero to displayed TVL, which can understate pool value and distort yield. See How Yield Is Generated for the annualization formula.

Value and exposure calculations

Let q be your LP balance, S supply, A_i raw LP-owned actual balance, d_i token decimals, and p_i USD price:

pool_TVL_USD = Σ(A_i / 10^d_i × p_i)
position_USD = pool_TVL_USD × q / S
token_claim_i = A_i × q / S
concentration_factor_i = virtual_balance_i / A_i

The concentration factor is undefined at A_i = 0 and can change through trading or manager updates. actual_balance already excludes protocol fees. Raw vault balances can include those fees and direct transfers not credited to LPs; they do not replace pool accounting.

Data and permissions

A balance snapshot is not a complete authority or risk configuration. Pool/config accounts also hold admins, manager settings, token activity, sell-off controls, and extension policy. LP token supply comes from its mint.

For indexed data, use API Reference. Direct API access requires a key; contact the Coffer team. For on-chain reads, events, and reconciliation, use Smart Contracts.

On this page