# Uniswap v3 Positions

![Uniswap v3 position example](/files/CKWAbWrlUjaABmJzr7l3)

### 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.\
\
\&#xNAN;*`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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.revert.finance/revert/position-analytics/uniswap-v3-positions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
