Skip to main content
The Get Wallet Trading Analysis endpoint returns comprehensive wallet trading analytics, 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.

​
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 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.
If you need all token positions in a wallet, use wallet/positions.

​
Walkthrough to Get Wallet Trading Analysis for a Wallet

​
1. Prepare your query

The wallet/analysis endpoint requires one parameter to work:
ParameterDescription
walletWallet 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 (100Mto100M to 1B)
  • 10M-100M
  • 1M-10M
  • 100k-1M
  • <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 Wallet Analysis Demo UI Docs

​
Summary

The Get Wallet Trading 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