Pool Total Return

Aggregates fees earned and impermanent loss for each liquidity provider in a pool to calculate pool level fees earned and impermanent loss. These values are calculated daily at midnight UTC.

👍

Protocols Supported

This endpoint only supports Uniswap v2.

👍

Blockchains Supported

This endpoint only supports data from ethereum-mainnet.

📘

Not specifying the endDate

If the endDate query parameter is not provided, the API will return the latest data, meaning from inception date up to the current date.

Response Data

FieldTypeDescription
payload.data[index].protocolstringThe name of the protocol, i.e. "uniswapv2".
payload.data[index].timestampnumberThe UTC midnight timestamp at which the results were calculated.
payload.data[index].poolAddressstringThe address of the token, i.e. the address of the pair or liquidity pool.
payload.data[index].token0AddressstringThe address of token0, i.e. the first token in the pool.
payload.data[index].token1AddressstringThe address of token1, i.e. the second token in the pool.
payload.data[index].tokens0IfHeldnumberToken0 the liquidity provider holds at the end of the query interval if they simply held them in his wallet instead of providing liquidity.

NOTE: This is not the reserve of token0 in the pool.
payload.data[index].tokens1IfHeldnumberToken1 the liquidity provider holds at the end of the query interval if they simply held them in his wallet instead of providing liquidity.

NOTE: This is not the reserve of token1 in the pool.
payload.data[index].tokens0LpnumberToken0 the liquidity provider holds at the end of the query interval.
payload.data[index].tokens1LpnumberToken1 the liquidity provider holds at the end of the query interval.
payload.data[index].change0numberThe difference between tokens0Lp and Tokens0IfHeld less fees. change0 = tokens0IfHeld - (tokens0Lp - fees0Total)
payload.data[index].change1numberThe difference between tokens1Lp and Tokens1IfHeld less fees. change1 = tokens1IfHeld - (tokens1Lp - fees1Total)
payload.data[index].fees0TotalnumberToken0 fees earned. fees0Total = fees0Unclaimed + fees0Claimed.
payload.data[index].fees1TotalnumberToken1 fees earned. fees1Total = fees1Unclaimed + fees1Claimed.
payload.data[index].price0numberPrice of token0 in USD.
payload.data[index].price1numberPrice of token1 in USD.
payload.data[index].feesnumberTotal fees earned in USD. fees = feesClaimed + feesUnclaimed.
payload.data[index].impermanentLossnumberLoss as a result of providing liquidity in USD.
payload.data[index].returnnumbertotal return in USD.
Language
Credentials
Header
Click Try It! to start a request and see the response here!