> ## 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 Trading Performance with PnL, Win Rate & Market Cap Distributions

> Easily analyze a wallet’s trading performance across Ethereum, Solana, Base & more using the Mobula API.

The [**Get Wallet Trading Analysis**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-analysis) endpoint returns comprehensive wallet trading analytics across chains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), and more, including **PnL**, **win rate distributions**, **market cap distributions**, and detailed trading statistics over a selected time period. It is ideal for developers building **smart money detection**, **wallet scoring**, **trader dashboards**, and **on-chain due diligence tools**.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/oRM5LcSS8C8" 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:

* Analyze wallet trading performance over a selected period (1d, 7d, 30d, 90d)
* Retrieve total performance metrics including realized and unrealized PnL
* Get a **win rate distribution** across profit/loss ranges
* Get a **market cap distribution** of traded tokens
* Review detailed trading statistics (buys, sells, volumes, win rate, holding behavior)
* Retrieve the wallet’s most profitable token (if available)
* Retrieve labels associated with the wallet (Smart Money, Early Adopter, etc.)

Unlike raw activity feeds, this endpoint is optimized for **performance analytics and wallet scoring**.

***

## 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 Trading Analysis

Use this endpoint when you want to:

* Track wallet PnL and trading performance over time
* Score wallets based on win rate and trading behavior
* Identify smart wallets using distribution metrics and labels
* Analyze risk profile through market cap exposure
* Research a wallet before following or copying trades

If you need wallet activity events like swaps and transfers, use [**wallet/activity**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity).\
If you need all token positions in a wallet, use [**wallet/positions**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-defi-positions).

***

## Walkthrough to Get Wallet Trading Analysis for a Wallet

### 1. Prepare your query

The `wallet`/`analysis` endpoint requires one parameter to work:

| Parameter | Description               |
| --------- | ------------------------- |
| `wallet`  | Wallet address to analyze |

Optional parameters you can use to control output:

* `blockchain`: analyze a specific blockchain (if not provided, analysis runs across all supported chains)
* `period`: analysis period (`1d`, `7d`, `30d`, `90d`), default is `7d`

### 2. Find a wallet address to test

To retrieve real wallet data:

1. Open DexScreener
2. Search for any token you want
3. Open the **Top Traders** section
4. Select an active wallet
5. Open it in the blockchain explorer
6. Copy the wallet address

This address is used as the `wallet` parameter.

### 3. Select your period (optional)

If you want a different window than the default:

* Use `period=1d` for short-term performance
* Use `period=30d` or `period=90d` for longer-term analysis

### 4. Fill the API form

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

***

## Reviewing the wallet trading analysis response

The response returns a single analytics object inside `data`, including:

### Win Rate Distribution

This summarizes how many trades fall into profit/loss ranges:

* `>500%`
* `200%-500%`
* `50%-200%`
* `0%-50%`
* `-50%-0%`
* `<-50%`

This is useful for quickly understanding if the wallet tends to make small consistent wins, large winners, or frequent losses.

### Market Cap Distribution

This shows what size of tokens the wallet trades most:

* `>1000M` (over \$1B)
* `>100M` ($100M to $1B)
* `10M-100M`
* `1M-10M`
* `100k-1M`
* `&lt;100k`

This is useful for profiling wallet risk and strategy (large caps vs micro caps).

### Trading Statistics (`stat` object)

Key trading metrics you can use for scoring and analytics, including:

* `totalValue` (current portfolio value in USD)
* `periodTotalPnlUSD` (realized + unrealized PnL for the period)
* `periodRealizedPnlUSD` and `periodRealizedRate`
* Buy/sell activity: `periodBuys`, `periodSells`, `periodVolumeBuy`, `periodVolumeSell`
* Token coverage: `periodTradingTokens`, `periodBuyTokens`, `periodSellTokens`
* Holding behavior: `holdingTokensCount`, `holdingDuration`
* Win performance: `winRealizedPnl`, `winRealizedPnlRate`
* `winToken` (most profitable token, if available)
* `fundingInfo` (initial wallet funding context, when available)
* `nativeBalance` (native token balance details)

### Period Timeframes

A time series of realized PnL points:

* `date`
* `realized`

This is useful for charts showing performance over time within the selected period.

### Labels

An array of labels tied to the wallet (examples: Smart Money, Early Adopter, etc.).

This can be used directly in UI badges or wallet ranking systems.

***

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

You can also test this endpoint using our demo UI:

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

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

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

***

## Summary

The [Get Wallet Trading Analysis](https://docs.mobula.io/rest-api-reference/endpoint/wallet-analysis) endpoint provides advanced wallet performance analytics, including:

* PnL tracking over a selected period
* Win rate distribution across profit/loss ranges
* Market cap distribution of traded tokens
* Detailed trading statistics for wallet scoring
* Timeframe-based realized PnL series
* Wallet labels for classification (when available)

If you’re building smart money detection, trader dashboards, or wallet scoring systems, 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/)