Published September 18, 2023

Uniswap V3 uses NFTs to represent liquidity positions. Unlike V2, where liquidity providers received ERC-20 LP tokens, V3 mints a unique NFT for each position. This NFT encodes the specifics of the position: the range of prices and the amount of liquidity provided. For a detailed understanding of Uniswap V3 NFTs, this article provides a comprehensive overview.

While this mechanism offers greater flexibility and capital efficiency, it also introduces complexities in tracking and valuing these positions. BlockSpan, with its advanced data analytics capabilities, bridges this gap by providing granular insights into the value of these NFT positions. In this blog, we'll delve deep into how BlockSpan achieves this and why it's a game-changer for DeFi enthusiasts.

BlockSpan's Unique Offering

Consider a recent transaction hash 0x32851a1d0c84871d7309e624cb671692509794b04c99f2817d84264a72669e1f. While platforms like Etherscan provide raw transaction data, BlockSpan goes a step further. Our API not only fetches the transaction details but also calculates the price of the NFT position.

{ "token_type": "erc721", "transaction_hash": "0x32851a1d0c84871d7309e624cb671692509794b04c99f2817d84264a72669e1f", "price": [ { "price": "14811.26527200842113112106", "price_currency": "ETH", "price_usd": "24607963.176187729610637229472603030121612", } ] }

From the above, we can infer that the NFT position was valued at approximately 14,811 ETH or roughly 24.6 million USD at the time of the transaction.

Why is this Important?

  1. Historical Analysis for Trading Strategies: By understanding the value of positions when they were taken, traders and liquidity providers can analyze historical data to refine their strategies. For instance, if a significant liquidity position was taken at a specific price range, it might indicate confidence in that range, which can be valuable information for future trades.

  2. Liquidity Alerts for DApps and DeFi Platforms: Platforms can set up alerts for their users when significant liquidity positions are taken or exited. This can be valuable information for traders looking to enter or exit positions.

  3. Research and Analysis: DeFi analysts can use this data to understand liquidity trends, identify whale activities, and study the correlation between liquidity provision and price movements.

Use Case: Strategic Liquidity Provision

Consider an algorithmic trading bot that provides liquidity on Uniswap V3. Using BlockSpan's API, the bot can:

const fetch = require('node-fetch'); async function fetchNftValue(transactionHash) { const endpoint = ""; const response = await fetch(endpoint + "?hash=" + transactionHash); const data = await response.json(); return data.results[0].price[0].price_usd; } // Example usage const transactionHash = "0x32851a1d0c84871d7309e624cb671692509794b04c99f2817d84264a72669e1f"; const nftValue = await fetchNftValue(transactionHash); console.log(`The historical value of the NFT position is: $${nftValue}`);

By monitoring the historical value of its NFT positions, the bot can make strategic decisions on where to provide liquidity next, based on past trends and performance.

Use Case: DeFi Portfolio Management

Imagine a DeFi enthusiast, Alice, who actively provides liquidity across various Uniswap V3 pools. With multiple positions across different price ranges and pools, tracking the historical value of each position can become cumbersome.

Using BlockSpan's API, a portfolio management tool can offer Alice a consolidated view of her NFT positions' historical value. This not only simplifies tracking but also aids in making informed decisions about future liquidity provision.

async function fetchUserNftValues(userAddress) { const endpoint = ""; const response = await fetch(endpoint + "?address=" + userAddress); const nftPositions = await response.json().results; const values = {}; for (let position of nftPositions) { const tokenId =; const valueUsd = position.price[0].price_usd; values[tokenId] = valueUsd; } return values; } // Example usage const aliceAddress = "0xExampleAliceAddress"; const nftValues = await fetchUserNftValues(aliceAddress); console.log(`Alice's NFT positions and their historical values:`, nftValues);

Use Case: NFT Marketplaces and Auction Platforms

NFT marketplaces and auction platforms can leverage BlockSpan's API to provide historical valuations of Uniswap V3 NFT positions listed for sale. This would enable potential buyers to understand the historical significance and value of the position they are considering purchasing. Moreover, sellers can ensure they are listing their positions with a clear understanding of its past value, providing transparency to potential buyers.


Uniswap V3's NFT-based liquidity positions have ushered in a new era of possibilities and challenges in the DeFi sector. While these positions offer enhanced flexibility, they also bring about intricate dynamics that can be challenging to navigate. BlockSpan's capability to provide historical valuation data for these positions is a testament to the evolving needs of the DeFi community. As we journey further into this decentralized future, tools that offer clarity, insight, and strategic value—like BlockSpan—will be indispensable for both newcomers and seasoned DeFi veterans alike.

Written by Nikhil

Other similar posts