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

# How to Track Wallet Balance and Wallet Positions with PnL Across Ethereum, Solana, Base & More

> Easily retrieve a wallet’s full token portfolio, enriched token metrics, and profit & loss (PnL) data using the Mobula API.

The [**Get Wallet Positions**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions) **with PnL** endpoint returns all enriched token positions for a wallet on a specific blockchain, including token metadata, liquidity, trade stats, and wallet-level PnL per token. It is ideal for developers building **wallet analytics, portfolio dashboards, trader tooling,** and **on-chain performance apps**.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/QJ4gbfA1tGo" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## What this endpoint does

With this API, you can:

* Retrieve **all token positions** in a wallet on a specific blockchain
* Get **wallet balances and USD values** per token
* Access **enriched token metrics** like liquidity, volume, trades, and holders
* Track **realized, unrealized, and total PnL** per token
* Analyze wallet trading stats per token (buys, sells, volume, average prices)

Unlike token-specific endpoints, this one gives you a **portfolio-wide view** of a wallet’s tokens (for one chain per request).

***

## What you’ll need

* Basic knowledge of REST APIs
* A wallet address
* A Mobula API key

Note: All Mobula endpoints require an API key.\
Get a free API key: [Here](https://admin.mobula.io/)

Optional:

* DexScreener (to find active wallets to test)

***

## When to use Get Wallet Positions with PnL

Use this endpoint when you want to:

* Build a wallet portfolio view (token list, balances, USD value)
* Track token-level wallet profitability with PnL
* Analyze wallet trading behavior across all holdings
* Power dashboards, wallet explorers, or trader profiling tools

If you only want one token position for a wallet, use [**wallet/position**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-position).\
If you want all token positions for a wallet, use [**wallet/positions**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions).

***

## Walkthrough to Get Wallet Positions for a Wallet

### 1. Prepare your query

The `wallet`/`positions` endpoint requires two parameters:

| Parameter    | Description               |
| ------------ | ------------------------- |
| `wallet`     | Wallet address to analyze |
| `blockchain` | Blockchain name or ID     |

### 2. Find a wallet address to test

To get a real wallet example:

1. Open DexScreener
2. Search for any token on the chain you want ([Solana](https://docs.mobula.io/blockchains/solana) or [Ethereum](https://docs.mobula.io/blockchains/ethereum))
3. Open the **Top Traders** or **Holders** section
4. Click a wallet and copy the wallet address

You will use this address as the `wallet` parameter.

### 3. Identify the blockchain

On DexScreener, check the chain for the token you used to find wallets.

This value is used as the `blockchain` parameter.

### 4. Fill the API form

Once the wallet address is filled (and optional filters are set), click **Send** to retrieve the wallet’s positions data.

***

## Reviewing the wallet positions response

### What you get per token position

* **Token metadata**: name, symbol, decimals, logo, contract address
* **Token market metrics**: price, liquidity, volume, trades, holders, market cap
* **Security and socials**: buy/sell tax, blacklist flags, top holders, and social links
* **Wallet position data**: balance, rawBalance, USD value
* **Trading stats**: buys, sells, buy/sell volumes, average buy/sell prices
* **PnL breakdown**: realized, unrealized, total PnL
* **Time bounds**: first and last interaction timestamps

This makes it easy to build a **wallet portfolio table** with profitability insights.

***

## Try It Live with Mobula Wallet Positions Demo (UI)

You can also test this endpoint using our demo UI:

[Demo UI Homepage](https://mobula-demo-endpoint-production.up.railway.app/)

[Wallet Positions Demo UI](https://mobula-demo-endpoint-production.up.railway.app/wallet-positions)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions)

***

## Summary

The [**Get Wallet Positions**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-positions) **with PnL** endpoint provides a full portfolio view of a wallet on a specific chain, including:

* Token balances and USD value
* Enriched token metrics (liquidity, trades, holders, security)
* Trading stats per token
* Realized and unrealized PnL per token

If you’re building wallet analytics that require **token-level profitability** and **enriched portfolio data**, this endpoint is the right choice.

***

## Try Mobula for Free

Try our free API today and start building in minutes.\
Get your free API key: [Here](https://admin.mobula.io/)

***