Position Analytics Response Fields

This page describes the fields of the response provided by the Position Analytics API

DailyPositionAnalytics

Returns an object containing two array elements:

• data: array containing the actual analytics data per day

• metadata: array listing the pool's tokens

Applicable for Uniswap V2 positions.

Parameter	Type	Description
data	array	array of objects containing the actual analytics data per day
--timestamp	long	date for which the analytics apply; unix timestamp format
--token0Amount	double	user's reserve in the pool: token0 balance
--token1Amount	double	user's reserve in the pool: token1 balance
--token0UsdRate	double	user's reserve in the pool: token0 USD valuation
--token1UsdRate	double	user's reserve in the pool: token1 USD valuation
--lpPrice	double	LP token price of the day
--lpTokenAmount	double	user's reserve in the pool: LP token balance
--dailyLpTokenMinted	double	user's reserve in the pool: amount of LP tokens gained for the day
--lpTokenValueUSD	double	user's reserve in the pool: LP token USD valuation
--userPoolShare	double	user's share of the pool at date (timestamp); %
--poolTvlUSD	double	overall pool's TVL at date (timestamp)
--dailyFeesToken0	double	user earned Fees (Yield) for the day: token0 balance
--dailyFeesToken1	double	user earned Fees (Yield) for the day: token1 balance
--dailyFeesToken0USD	double	user earned Fees (Yield) for the day: token0 USD valuation
--dailyFeesToken1USD	double	user earned Fees (Yield) for the day: token1 USD valuation
--dailyFeesUSD	double	overall user earned Fees (Yield) for the day: USD valuation
--cumulativeFeesToken0	double	user cumulated Fees (Yield) to data: token0 balance
--cumulativeFeesToken1	double	user cumulated Fees (Yield) to data: token1 balance
--cumulativeFeesToken0USD	double	user cumulated Fees (Yield) to data: token0 USD valuation
--cumulativeFeesToken1USD	double	user cumulated Fees (Yield) to data: token1 USD valuation
--cumulativeFeesUSD	double	overall user cumulated Fees to date: USD valuation
--dailyTxFees	double	user position amount of transaction fees for the day: native token balance; if transactions occurred during the day
--dailyTxFeesUSD	double	user position amount of transaction fees for the day: USD valuation; if transactions occurred during the day
--cumulativeTxFees	double	user position cumulated transaction fees to date: native token balance
--cumulativeTxFeesUSD	double	user position cumulated transaction fees to date: USD valuation
--events	array of object	list of transactions which occurred during the day on the user's position
--/--timestamp	long	date & time of the transaction; unix timestamp format
--/--blockNumber	long	blockchain block number containing the transaction
--/--eventType	string	module's function name
--/--balances	array of <long, biginteger>	token movements: tokenID and amount moved
--/--isOpposite	boolean	opposite transaction available (identified)
--/--transaction	string	transaction hash
--/--txInfo	object	transaction related information
--/--/--txFee	biginteger	amount of transaction fees
--/--/--txFeeUSDD	double	amount of transaction fees USD valuation
metadata	array	listing the pool's tokens
--address	string	token ID
--symbol	string	token symbol
--name	string	token symbol
--decimals	long	token value number of decimals
--logo	string	URL link to token logo

PositionsSnapshotAnalytics

Applies for Uniswap V2 & V3 positions.

Parameter	Type	Details
timestamp	long	date & time for which the analytics apply; unix timestamp format
blockNumber	long
lpTokensData	array	list of objects, user's positions with their corresponding current (timestamp) analytics status; the id key is: LP address for Uniswap V2 NFT ID for Uniswap V3
--lpTokenAddress	string	LP token address
--nftId	biginteger	position NFT ID for Uniswap V3
--underlyingTokens	array of string	array with the position's underlying token addresses
--lpTokensMinted	biginteger	amount of LP token minted for the day
--lpPriceUsd	double	LP price of the day
--dailyFeesUsd	double	Fees (Yield) for the date
--cumulativeFeesUsd	double	Total Fees (Yield) cumulated to date
--collectedFeesUsd	double	Fees (Yield) collected to date
--dailyTxFeesUsd	double	transaction fees of the day USD valuation; if movement during the day
--cumulativeTxFeesUsd	double	cumulated transaction fees to date, for the position
--currencyDiffUsd	double	position's underlying tokens current price fluctuation with regard to token entry price
--pnLUsdPnLToDate	double	position total P&L: Cumulative Fees + Cumulative Tx Fees + Currency Difference
--pnLUsdRealized	double	realized P&L, in relation with collected Yield
--impermanentLoss	double	impermanent loss USD value to date