> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dexutils.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Portfolio Tracker: Monitor Your DeFi Wallet Performance

> Connect your wallet to DexUtils Portfolio Tracker for a unified view of token balances, LP positions, PnL, and transaction history.

The DexUtils Portfolio Tracker aggregates all your token holdings, LP positions, and transaction history from one or more wallet addresses into a single dashboard. You get live USD values, profit and loss calculations, impermanent loss estimates, and a full export-ready history — without ever connecting a browser wallet or granting any permissions. All data comes from public on-chain records.

## Adding a Wallet

To start tracking a wallet, open the Portfolio Tracker from the left sidebar and paste in any public wallet address. No browser wallet extension or signature is needed — the tracker works entirely from your on-chain address.

<Warning>
  DexUtils will **never** ask for your private key, seed phrase, or any wallet signature. The Portfolio Tracker is entirely read-only and works from your public wallet address alone. If any page or pop-up on DexUtils asks for a private key or seed phrase, do not enter it and report it immediately.
</Warning>

<Steps>
  <Step title="Open the Portfolio Tracker">
    Click **Portfolio** in the left sidebar. If this is your first visit, you'll land on an empty dashboard with an address input prompt.
  </Step>

  <Step title="Enter your wallet address">
    Paste your public wallet address (e.g., a `0x...` Ethereum address or equivalent for other supported chains) into the input field. You do not need to connect a browser wallet extension.
  </Step>

  <Step title="Select the chains to scan">
    Choose one or more blockchains to scan for balances and activity. DexUtils will index all supported chains you select. You can add more chains to any wallet later from the wallet settings panel.
  </Step>

  <Step title="Wait for the initial sync">
    DexUtils fetches your token balances, LP positions, and transaction history. Initial sync typically takes 15–60 seconds depending on wallet activity. A progress indicator shows which chains are still loading.
  </Step>

  <Step title="Label your wallet (optional)">
    Once the wallet loads, click the **pencil icon** next to the address and give it a label such as "Trading wallet" or "Cold storage". Labels are stored locally in your browser and help you identify wallets quickly when you track multiple addresses.
  </Step>
</Steps>

## What You See After Connecting

### Token Balances

The **Balances** panel lists every token held in the wallet with a non-zero balance on the scanned chains. For each token you can see:

* Token name, symbol, and contract address
* Current quantity held
* Live USD value (updated in real time from DexUtils price feeds)
* 24h price change percentage

Click any token row to jump to its Token Analytics page.

### LP Positions

The **LP Positions** panel detects liquidity pool tokens held by the wallet and decodes them into their underlying assets. For each LP position you can see:

* Pool name and DEX
* Your share of the pool as a percentage
* Current value of your share in USD
* Estimated impermanent loss compared to simply holding the two tokens

<Note>
  Impermanent loss estimates are approximations based on the price ratio at the time you added liquidity versus the current price ratio. DexUtils calculates these from your first detected deposit event. If you added liquidity in multiple transactions, the estimate uses the weighted average entry price. Treat IL estimates as directional guidance, not precise accounting figures.
</Note>

### Realized and Unrealized PnL

The **PnL** panel breaks down profit and loss at the individual token level:

* **Unrealized PnL** — the difference between your current position value and your estimated cost basis, derived from historical buy transactions
* **Realized PnL** — profit or loss locked in from completed sell transactions, calculated using the actual transaction prices

Each token row shows both figures in USD and as a percentage. The panel header shows your aggregate portfolio PnL across all tokens and positions.

### Transaction History

The **History** tab lists every on-chain transaction associated with the wallet in reverse chronological order. Each entry shows:

* Transaction type (swap, LP add, LP remove, transfer, approval)
* Tokens in and tokens out, with quantities
* USD value of the transaction **at the time it occurred**, sourced from historical price data
* Gas fee in the native token and USD equivalent
* Block explorer link

Use the search bar and filters above the history table to narrow by date range, transaction type, or token.

## Multi-Wallet Support

You can add as many wallet addresses as you like to your Portfolio Tracker. Each wallet appears as a separate tab across the top of the dashboard.

<CardGroup cols={2}>
  <Card title="Per-wallet view" icon="wallet">
    Click any wallet tab to see balances, positions, PnL, and history scoped to that wallet only.
  </Card>

  <Card title="Aggregate view" icon="layer-group">
    Click **All Wallets** to see a combined view that sums balances and PnL across every tracked address.
  </Card>
</CardGroup>

To remove a wallet, open the wallet tab, click the **settings icon**, and select **Remove wallet**. This only removes it from your local tracker — it has no effect on the wallet or its on-chain funds.

## Exporting Data

Click the **Export** button in the top-right corner of the Portfolio Tracker to download your transaction history as a CSV file. The export includes:

* Date and time (UTC)
* Transaction type
* Token in / token out with quantities
* USD value at time of transaction
* Fee amount and USD equivalent
* Transaction hash

This format is designed to be compatible with common crypto tax software. Select a custom date range before exporting to limit the file to a specific tax year or reporting period.

<Tip>
  For tax reporting, export one CSV per wallet per tax year to keep files manageable and clearly organized by address and period.
</Tip>

## Privacy

DexUtils reads only publicly available on-chain data. Your wallet address, balances, and transaction history are all visible to anyone on the blockchain — DexUtils does not expose any information that isn't already public. No wallet connection, signature, or account login is required to use the Portfolio Tracker. Wallet labels you create are stored in your browser's local storage and are never sent to DexUtils servers.
