Sunswap is managed through V3 NFT positions from funding to exit

Funding the range and minting the position NFT

Funding a Sunswap V3 range mints one NFT that binds the deposit to fixed pool settings.

Start by connecting TronLink or TokenPocket to TRON, then open Earn, choose Liquidity Pools and select V3. Pick exactly two TRC-20 assets, such as WTRX and USDT, and select the existing pool that matches the intended fee tier. A new pool also needs an initial exchange rate. Set one lower boundary and one upper boundary, enter the token amount and review the automatically calculated second amount. The Provide action triggers any missing token approval before the wallet signs the mint transaction.

Use this five-point decision check before the wallet creates the position:

• Both token contract addresses match the intended TRC-20 assets.
• The fee tier matches the exact pool and its expected price movement.
• The lower price sits below the upper price in the displayed quote direction.
• The current price sits where the intended one-token or two-token deposit requires.
• The wallet holds enough TRON Energy, Bandwidth or TRX to complete approval and mint calls.

Sunswap V3 supports four fixed pool fee tiers: 0.01%, 0.05%, 0.3% and 1%.

The contracts encode those tiers as 100, 500, 3000 and 10000 parts per million. Their usable tick spacings are 1, 10, 60 and 200 ticks in the same order, while every tick changes the price ratio by a factor of 1.0001. Narrower boundaries concentrate more liquidity around the current tick and require more frequent monitoring. Once the mint confirms, the NonfungiblePositionManager assigns one token ID and the wallet receives the TRC-721 position NFT. That token ID anchors later balance checks, top-ups and exits.

Reading the NFT balance and active range

The Sunswap position page shows the NFT balance, token mix and whether its range is active. One position ties together two token addresses, one fee tier, two boundary ticks and a liquidity value. The record exposes 12 fields, including token0, token1, tickLower, tickUpper, liquidity, tokensOwed0 and tokensOwed1. Compare the current price with both boundaries: inside means active, while either side means inactive. TronWeb integrators read slot0, where sqrtPriceX96 uses Q64.96 encoding and the current tick supplies the range test.

What happens when the price leaves the range?

A Sunswap V3 position becomes inactive and holds one token after price crosses either range boundary. Active liquidity stops serving swaps at that point, so it stops accruing new trading fees. Fees earned before the crossing remain attached to the NFT. If price later returns between the two ticks, the existing position becomes active again without a wallet transaction.

The three observable states are below range, inside range and above range. Below one boundary, the position converts toward one pool asset; above the other, it converts toward the opposite asset. Token0 and token1 follow contract-address ordering, so the interface’s quote direction decides which named token appears on each side. Reversing the displayed pair also reverses the human-readable boundary prices. A range owner should therefore read the current-price marker and both asset balances together. Creating a different range requires a second NFT with new lower and upper ticks.

Adding funds without changing the range

A Sunswap top-up increases liquidity inside the NFT’s existing range, pair and fee tier. The Add action changes principal size rather than position geometry.

Open My Positions, choose the relevant token ID and select Add. The page locks the two TRC-20 contracts, four-tier fee choice and two price boundaries from the original mint. Enter one amount; the interface calculates the second from the current pool price and range location. An in-range position normally needs both tokens, while an out-of-range position accepts the single asset that its current side requires. Confirm the displayed contribution before signing because price movement between quote and execution changes the final amount that the contract uses.

The increaseLiquidity call carries six fields: one token ID, two desired amounts, two minimum amounts and one deadline. Minimum amounts enforce the wallet’s chosen execution tolerance, while the deadline limits how long the signed call remains valid. A top-up also needs enough TRC-20 allowance for each token that the contract draws. Every state-changing call uses Bandwidth and Energy; insufficient resources cause TRX to cover the network cost. One TRX equals 1,000,000 sun, while uppercase SUN names a separate governance token.

Removing principal and collecting two token balances

A Sunswap exit removes principal first, then collects both tokens owed to the NFT. Choose a partial percentage to shrink the position or 100% to set its liquidity to zero.

At contract level, decreaseLiquidity accepts five fields: token ID, liquidity amount, two minimum token amounts and a deadline. The minimums protect the two-token withdrawal from an execution change between preview and inclusion. Removing liquidity leaves the range, fee tier and NFT record intact. A partial exit keeps the remaining liquidity active whenever price stays inside its original two bounds. The updated position page should show the smaller liquidity value and revised amounts after the TRON receipt reports successful execution.

Decreased principal and earned fees appear as two owed-token balances before collection transfers them to the recipient wallet. The collect call has four inputs: token ID, recipient and maximum amounts for token0 and token1. Fees never compound automatically into the V3 range; collecting sends them out, while compounding requires a separate top-up. The NFT can be burned only after liquidity equals 0 and both owed-token counters equal 0. This three-condition gate keeps the certificate until no value remains attached.

Read the wallet’s final TRC-20 balances, not only the removed-liquidity banner. WTRX represents TRX inside V3 contracts, so an exit from a WTRX pair returns WTRX unless the interface also unwraps it. TRON produces blocks on 3-second slots, while solidified finality requires at least 19 of 27 active Super Representatives to reach the transaction block height or move beyond it. For balance reconciliation, the solidified receipt closes the lifecycle.

The V3 lifecycle beside newer and older Sunswap pools

The Sunswap V3 NFT workflow remains distinct from V2 shares and V4 programmable positions. V3 launched June 28, 2023 and remains selectable on TRON. V2 represents a pool share with fungible LP tokens and spreads liquidity across the full curve. V3 assigns one non-fungible certificate per chosen range. V4, launched March 2, 2026, keeps concentrated liquidity while adding Hooks, Singleton architecture and native TRX alongside WTRX. V3 positions follow the same mint, monitor, increase, decrease and collect sequence.