Skip to main content

IUniswapV3PoolState

These methods compose the pool's state, and can change with any frequency including multiple times per transaction

Functions#

slot0#

function slot0(
) external view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)

The 0th storage slot in the pool stores many values, and is exposed as a single method to save gas when accessed externally.

Return Values:#

NameTypeDescription
sqrtPriceX96uint160The current price of the pool as a sqrt(token1/token0) Q64.96 value
tickint24The current tick of the pool, i.e. according to the last tick transition that was run. This value may not always be equal to SqrtTickMath getTickAtSqrtRatio(sqrtPriceX96) if the price is on a tick boundary.
observationIndexuint16The index of the last oracle observation that was written,
observationCardinalityuint16The current maximum number of observations stored in the pool,
observationCardinalityNextuint16The next maximum number of observations, to be updated when the observation.
feeProtocoluint8The protocol fee for both tokens of the pool. Encoded as two 4 bit values, where the protocol fee of token1 is shifted 4 bits and the protocol fee of token0is the lower 4 bits.Used as the denominator of a fraction of the swap fee, e.g. 4 means 1/4th of the swap fee.
unlockedboolWhether the pool is currently locked to reentrancy

feeGrowthGlobal0X128#

function feeGrowthGlobal0X128(
) external view returns (uint256)

The fee growth as a Q128.128 fees of token0 collected per unit of liquidity for the entire life of the pool

This value can overflow the uint256

feeGrowthGlobal1X128#

function feeGrowthGlobal1X128(
) external view returns (uint256)

The fee growth as a Q128.128 fees of token1 collected per unit of liquidity for the entire life of the pool

This value can overflow the uint256

protocolFees#

function protocolFees(
) external view returns (uint128 token0, uint128 token1)

The amounts of token0 and token1 that are owed to the protocol

Protocol fees will never exceed uint128 max in either token

liquidity#

function liquidity(
) external view returns (uint128)

The currently in range liquidity available to the pool

This value has no relationship to the total liquidity across all ticks

ticks#

function ticks(
int24 tick
) external view returns (uint128 liquidityGross, int128 liquidityNet, uint256 feeGrowthOutside0X128, uint256 feeGrowthOutside1X128)

Look up information about a specific tick in the pool

Parameters:#

NameTypeDescription
tickint24The tick to look up

Return Values:#

NameTypeDescription
liquidityGrossint24the total amount of position liquidity that uses the pool either as tick lower or tick upper,
liquidityNetint128how much liquidity changes when the pool price crosses the tick,
feeGrowthOutside0X128uint256the fee growth on the other side of the tick from the current tick in token0,
feeGrowthOutside1X128uint256the fee growth on the other side of the tick from the current tick in token1, feeGrowthOutsideX128 values can only be used if the tick is initialized, i.e. if liquidityGross is greater than 0. In addition, these values are only relative and are used to compute snapshots.

tickBitmap#

function tickBitmap(
) external view returns (uint256)

Returns 256 packed tick initialized boolean values. See TickBitmap for more information

secondsOutside#

function secondsOutside(
) external view returns (uint256)

Returns 8 packed tick seconds outside values. See SecondsOutside for more information

positions#

function positions(
bytes32 key
) external view returns (uint128 _liquidity, uint256 feeGrowthInside0LastX128, uint256 feeGrowthInside1LastX128, uint128 tokensOwed0, uint128 tokensOwed1)

Returns the information about a position by the position's key

Parameters:#

NameTypeDescription
keybytes32The position's key is a hash of a preimage composed by the owner, tickLower and tickUpper

Return Values:#

NameTypeDescription
_liquiditybytes32The amount of liquidity in the position,
feeGrowthInside0LastX128uint256fee growth of token0 inside the tick range as of the last mint/burn/poke,
feeGrowthInside1LastX128uint256fee growth of token1 inside the tick range as of the last mint/burn/poke,
tokensOwed0uint128the computed amount of token0 owed to the position as of the last mint/burn/poke,
tokensOwed1uint128the computed amount of token1 owed to the position as of the last mint/burn/poke

observations#

function observations(
uint256 index
) external view returns (uint32 blockTimestamp, int56 tickCumulative, uint160 liquidityCumulative, bool initialized)

Returns data about a specific observation index

You most likely want to use #observe() instead of this method to get an observation as of some amount of time ago, rather than at a specific index in the array.

Parameters:#

NameTypeDescription
indexuint256The element of the observations array to fetch

Return Values:#

NameTypeDescription
blockTimestampuint256The timestamp of the observation,
tickCumulativeint56the current tick multiplied by seconds elapsed for the life of the pool as of the observation,
liquidityCumulativeuint160the current liquidity multiplied by seconds elapsed for the life of the pool as of the observation,
initializedboolwhether the observation has been initialized and the values are safe to use