# Uniswap V3 Positions

### 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.

Last updated