Skip to main content
The Get 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.

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

​
Walkthrough to Get Wallet Positions for a Wallet

​
1. Prepare your query

The wallet/positions endpoint requires two parameters:
ParameterDescription
walletWallet address to analyze
blockchainBlockchain 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 or 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 Wallet Positions Demo UI Docs

​
Summary

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