Skip to main content
This endpoint allows you to get wallet balance for a specific token, analyze trading activity, and track realized and unrealized PnL across supported blockchains. The Get Wallet Position endpoint is ideal for developers building wallet analytics, trader dashboards, or on-chain performance tools.

​
What this endpoint does

With this API, you can:
  • Get a crypto wallet balance for a specific token
  • Retrieve detailed wallet position data
  • Analyze buy and sell history for a wallet
  • Calculate realized and unrealized PnL
  • Access enriched token market data
Unlike portfolio-level endpoints, this endpoint focuses on one wallet + one token, making it perfect for deep wallet analysis.

​
What you’ll need

  • Basic knowledge of REST APIs
  • A wallet address (EVM or Solana)
  • A token (asset) address
  • The blockchain where the token exists (Ethereum, Solana, Base, etc.)
Optional:
  • DexScreener (to discover tokens and active wallets)

​
When to use Get Wallet Position

Use this endpoint when you want to:
  • Get wallet balance for a specific token
  • Analyze wallet trading performance
  • Track wallet PnL over time
  • Build wallet analytics or trader profiling tools
  • Display token-level wallet data in dashboards

​
Walkthrough — Get Wallet Balance for a Token

​
1. Prepare your query

The wallet/position endpoint requires three parameters:
ParameterDescription
assetToken contract address
blockchainBlockchain name or ID
walletWallet address to analyze

​
2. Find a token (asset address)

To get a valid token address:
  1. Open DexScreener
  2. Search for the token you want to analyze
  3. Copy the token contract address shown on the token page
This address is used as the asset parameter.

​
3. Identify the blockchain

Still on DexScreener:
  • Check which blockchain the token is deployed on (e.g. Solana, Ethereum, Base)
This value is used as the blockchain parameter.

​
4. Find a wallet address

To retrieve real wallet data:
  1. Open the Top Traders section on DexScreener
  2. Select an active wallet
  3. Open it in the blockchain explorer
  4. Copy the wallet address
This address is used as the wallet parameter.

​
Execute the API Call

​
Using cURL

curl -X GET \
  "https://demo-api.mobula.io/api/2/wallet/position?wallet=YOUR_WALLET&asset=TOKEN_ADDRESS&blockchain=solana"
This request fetches wallet balance, wallet position, and wallet PnL for the selected token.

​
Using the Mobula SDK

import { Mobula } from '@mobula/sdk';

const mobula = new Mobula({ apiKey: 'your-key' });

const position = await mobula.fetchWalletPosition({
  wallet: 'YOUR_WALLET',
  blockchain: 'Solana',
  asset: 'TOKEN_ADDRESS',
});

​
Review the wallet data response

The response returns detailed wallet data, including:
  • Token metadata and pricing
  • Token balance (raw and formatted)
  • Wallet value in USD
  • Buy and sell counts
  • Trading volumes
  • Average buy and sell prices
  • Realized PnL
  • Unrealized PnL
  • Total wallet profit and loss
  • First and last interaction timestamps
This allows you to fully analyze wallet balance, trading behavior, and profitability for a specific asset.

​
Try It Live with Mobula Wallet Position Demo (UI)

You can also test the Get Wallet Position endpoint using our open-source Wallet Position UI demo. This lightweight application uses Mobula cURL requests under the hood to fetch wallet balance, wallet data, and PnL for a specific token and blockchain, allowing you to validate parameters before integrating the API into your own application. Try it Here

​
Summary

The Get Wallet Position endpoint lets you go beyond basic wallet balances by providing token-level wallet data, trading history, and PnL. If you’re building tools that require:
  • Accurate wallet balance tracking
  • Token-specific wallet analytics
  • Advanced on-chain wallet insights
This endpoint is the right choice.