Uniswap V3 Positions

Example

Uniswap v3 position definitions

pooled_assets:

Value in USD of the position.

apr:

Annual percentage rate of returns given the current value of the underlying position assets including deposits, withdrawals, gas costs, and staking rewards at current prices.

fee apr:

Annual percentage rate of returns considering the accrued fees only. Does not account for divergence loss.

apr_excluding_gas:

Annual percentage rate of returns considering the value of the underlying position and the accrued fees, and divergence loss. Does not account for gas costs.

pool_pnl:

Profit and loss for the position from only fees accrued and price divergence.

Pool PnL = value of current LP underlying tokens - value of tokens deposited (at current price) + value of tokens withdrawn (at current price)

total_pnl (vs HOLD):

Total PnL = USD value of underlying tokens (at current price) - USD value of tokens deposited (at current price) + USD value of tokens withdrawn (at current price) + USD value of pending rewards (at current price) + USD value of claimed rewards (at current price) - USD value of gas costs at current ETH price.

total_pnl (vs ETH):

Total PnL = ETH value of underlying tokens (at current price) - ETH value of tokens deposited (at deposit price) + ETH value of tokens withdrawn (at withdrawal price) + ETH value of pending rewards (at current prices) + ETH value of claimed rewards at (at claim price) - ETH value of gas costs.

total_pnl (vs USD):

Total PnL = USD value of current underlying tokens - USD value of tokens deposited (at deposit price) + USD value of tokens withdrawn (at withdrawal price) + USD value of pending rewards (at current price) + USD value of claimed rewards (at claim price) - USD value of gas costs (at tx price).

current_assets:

The amount of underlying tokens corresponding to this LP position.

invested_assets:

The sum of all assets invested in the position.

withdrawn:

The sum of all assets withdrawn out of the position.

diffs:

The difference between the assets invested, subtracting the assets withdrawn, and the current assets in the LP position. diffs = current assets - invested assets + withdrawn assets

unclaimed_rewards:

The sum of all detected unclaimed staking reward assets for the account and pool.

claimed_rewards:

The sum of all detected claimed staking reward assets for the account and pool.

Pool definitions

reserves:

USD value of the underlying token reserves for the pool.

volume:

USD value of the traded volume for the pool.

price_divergence:

The running difference between the changes in prices (as percentages) for the underlying assets against the prices 30 days ago. Price divergences between a pair of assets can result in losses for liquidity providers. Price Divergence = abs(token0_price_change_pct - token1_price_change_pt)

position_age

The amount of time (in days) that have passed since the position was first created.