> ## 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. # Get Wallet Position with PnL > Fetch the position of a specific token for a wallet on a given blockchain, including balances, trade volumes, PnL, and token details. Supports both single (GET) and batch (POST) requests. ## OpenAPI ````yaml get /2/wallet/position openapi: 3.0.0 info: version: 1.0.0 title: Mobula API description: >- Documentation of the Mobula API **Demo API**: The default server (demo-api.mobula.io) is a demo API with rate limits. For production use, please use api.mobula.io with an API key from https://admin.mobula.io servers: - url: https://demo-api.mobula.io/api/ description: Demo API (rate limited, for testing only) - url: https://api.mobula.io/api/ description: Production API (requires API key) security: [] tags: - name: V2 - Token description: Token details, price, security, ATH, and holder data - name: V2 - Market Data description: Market details, OHLCV history, and lighthouse metrics - name: V2 - Trades description: Token trades, enriched trades, and trade filters - name: V2 - Wallet description: Wallet positions, activity, trades, analysis, and labels - name: V2 - Assets description: Cross-chain asset details and price history - name: V2 - Swap description: Swap quoting and execution - name: V2 - Perps description: Perpetual futures quoting, execution, and positions - name: V2 - Bridge description: Cross-chain bridge quoting and intent status (Alpha Preview) - name: V2 - DeFi description: Bonding pools and pulse data - name: V2 - Search description: Universal fast search - name: V2 - Blockchains description: System metadata and chain listings - name: V1 - Market Data description: Market prices, history, sparklines, pairs, and multi-data - name: V1 - Wallet description: Wallet portfolio, transactions, history, and NFTs - name: V1 - Token description: First buyers - name: V1 - Trades description: Market trades by pair - name: V1 - Metadata description: Token metadata, categories, trendings, and news - name: V1 - Assets description: List all assets - name: V1 - Search description: Search for assets, tokens, and pairs - name: V1 - DeFi description: Bonding pool pulse data - name: V1 - Blockchains description: Blockchain listings, pairs, and stats - name: V1 - Webhooks description: Webhook management - name: V1 - Feed description: Custom feed creation paths: /2/wallet/position: get: tags: - V2 - Wallet summary: Get Single Wallet Position description: >- Get position data for a specific wallet and asset. Returns balance, PnL, buy/sell volumes, and token details. parameters: - schema: type: string description: Wallet address required: true description: Wallet address name: wallet in: query - schema: type: string description: Token contract address required: true description: Token contract address name: asset in: query - schema: type: string description: Blockchain chain ID (e.g., "evm:56", "solana:solana") required: false description: Blockchain chain ID (e.g., "evm:56", "solana:solana") name: chainId in: query responses: '200': description: Single wallet position response content: application/json: schema: type: object properties: data: type: object properties: token: type: object properties: address: type: string chainId: type: string symbol: type: string nullable: true name: type: string nullable: true decimals: type: number nullable: true default: 0 id: type: number nullable: true default: null priceUSD: type: number nullable: true default: 0 priceToken: type: number nullable: true default: 0 priceTokenString: type: string approximateReserveUSD: type: number nullable: true default: 0 approximateReserveTokenRaw: type: string approximateReserveToken: type: number nullable: true default: 0 totalSupply: type: number nullable: true default: 0 circulatingSupply: type: number nullable: true default: 0 marketCapUSD: type: number nullable: true default: 0 marketCapDilutedUSD: type: number nullable: true default: 0 logo: type: string nullable: true originLogoUrl: type: string nullable: true rank: type: number nullable: true default: null cexs: type: array items: type: string default: [] exchange: type: object properties: name: type: string logo: type: string required: - name - logo factory: type: string nullable: true source: type: string nullable: true sourceFactory: type: string nullable: true sourceMetadata: type: object nullable: true properties: name: type: string logo: type: string required: - name - logo sourceFactoryMetadata: type: object nullable: true properties: name: type: string logo: type: string required: - name - logo liquidityUSD: type: number nullable: true liquidityMaxUSD: type: number nullable: true bonded: type: boolean bondingPercentage: type: number nullable: true bondingCurveAddress: type: string nullable: true preBondingFactory: type: string poolAddress: type: string blockchain: type: string type: type: string tokenType: type: string nullable: true enum: - '2020' - '2022' deployer: type: string nullable: true bondedAt: type: string nullable: true athUSD: type: number nullable: true atlUSD: type: number nullable: true athDate: type: string nullable: true atlDate: type: string nullable: true priceChange1minPercentage: type: number nullable: true default: 0 priceChange5minPercentage: type: number nullable: true default: 0 priceChange1hPercentage: type: number nullable: true default: 0 priceChange4hPercentage: type: number nullable: true default: 0 priceChange6hPercentage: type: number nullable: true default: 0 priceChange12hPercentage: type: number nullable: true default: 0 priceChange24hPercentage: type: number nullable: true default: 0 poolPriceChange1minPercentage: type: number nullable: true default: 0 poolPriceChange5minPercentage: type: number nullable: true default: 0 poolPriceChange1hPercentage: type: number nullable: true default: 0 poolPriceChange4hPercentage: type: number nullable: true default: 0 poolPriceChange6hPercentage: type: number nullable: true default: 0 poolPriceChange12hPercentage: type: number nullable: true default: 0 poolPriceChange24hPercentage: type: number nullable: true default: 0 liquidityBurnPercentage: type: number nullable: true volume1minUSD: type: number nullable: true default: 0 volume5minUSD: type: number nullable: true default: 0 volume15minUSD: type: number nullable: true default: 0 volume1hUSD: type: number nullable: true default: 0 volume4hUSD: type: number nullable: true default: 0 volume6hUSD: type: number nullable: true default: 0 volume12hUSD: type: number nullable: true default: 0 volume24hUSD: type: number nullable: true default: 0 volumeBuy1minUSD: type: number nullable: true default: 0 volumeBuy5minUSD: type: number nullable: true default: 0 volumeBuy15minUSD: type: number nullable: true default: 0 volumeBuy1hUSD: type: number nullable: true default: 0 volumeBuy4hUSD: type: number nullable: true default: 0 volumeBuy6hUSD: type: number nullable: true default: 0 volumeBuy12hUSD: type: number nullable: true default: 0 volumeBuy24hUSD: type: number nullable: true default: 0 volumeSell1minUSD: type: number nullable: true default: 0 volumeSell5minUSD: type: number nullable: true default: 0 volumeSell15minUSD: type: number nullable: true default: 0 volumeSell1hUSD: type: number nullable: true default: 0 volumeSell4hUSD: type: number nullable: true default: 0 volumeSell6hUSD: type: number nullable: true default: 0 volumeSell12hUSD: type: number nullable: true default: 0 volumeSell24hUSD: type: number nullable: true default: 0 trades1min: type: number nullable: true default: 0 trades5min: type: number nullable: true default: 0 trades15min: type: number nullable: true default: 0 trades1h: type: number nullable: true default: 0 trades4h: type: number nullable: true default: 0 trades6h: type: number nullable: true default: 0 trades12h: type: number nullable: true default: 0 trades24h: type: number nullable: true default: 0 buys1min: type: number nullable: true default: 0 buys5min: type: number nullable: true default: 0 buys15min: type: number nullable: true default: 0 buys1h: type: number nullable: true default: 0 buys4h: type: number nullable: true default: 0 buys6h: type: number nullable: true default: 0 buys12h: type: number nullable: true default: 0 buys24h: type: number nullable: true default: 0 sells1min: type: number nullable: true default: 0 sells5min: type: number nullable: true default: 0 sells15min: type: number nullable: true default: 0 sells1h: type: number nullable: true default: 0 sells4h: type: number nullable: true default: 0 sells6h: type: number nullable: true default: 0 sells12h: type: number nullable: true default: 0 sells24h: type: number nullable: true default: 0 buyers1min: type: number nullable: true default: 0 buyers5min: type: number nullable: true default: 0 buyers15min: type: number nullable: true default: 0 buyers1h: type: number nullable: true default: 0 buyers4h: type: number nullable: true default: 0 buyers6h: type: number nullable: true default: 0 buyers12h: type: number nullable: true default: 0 buyers24h: type: number nullable: true default: 0 sellers1min: type: number nullable: true default: 0 sellers5min: type: number nullable: true default: 0 sellers15min: type: number nullable: true default: 0 sellers1h: type: number nullable: true default: 0 sellers4h: type: number nullable: true default: 0 sellers6h: type: number nullable: true default: 0 sellers12h: type: number nullable: true default: 0 sellers24h: type: number nullable: true default: 0 traders1min: type: number nullable: true default: 0 traders5min: type: number nullable: true default: 0 traders15min: type: number nullable: true default: 0 traders1h: type: number nullable: true default: 0 traders4h: type: number nullable: true default: 0 traders6h: type: number nullable: true default: 0 traders12h: type: number nullable: true default: 0 traders24h: type: number nullable: true default: 0 feesPaid1minUSD: type: number nullable: true default: 0 feesPaid5minUSD: type: number nullable: true default: 0 feesPaid15minUSD: type: number nullable: true default: 0 feesPaid1hUSD: type: number nullable: true default: 0 feesPaid4hUSD: type: number nullable: true default: 0 feesPaid6hUSD: type: number nullable: true default: 0 feesPaid12hUSD: type: number nullable: true default: 0 feesPaid24hUSD: type: number nullable: true default: 0 totalFeesPaidUSD: type: number nullable: true default: 0 totalFeesPaidNativeRaw: type: string nullable: true default: '0' organicTrades1min: type: number nullable: true default: 0 organicTrades5min: type: number nullable: true default: 0 organicTrades15min: type: number nullable: true default: 0 organicTrades1h: type: number nullable: true default: 0 organicTrades4h: type: number nullable: true default: 0 organicTrades6h: type: number nullable: true default: 0 organicTrades12h: type: number nullable: true default: 0 organicTrades24h: type: number nullable: true default: 0 organicTraders1min: type: number nullable: true default: 0 organicTraders5min: type: number nullable: true default: 0 organicTraders15min: type: number nullable: true default: 0 organicTraders1h: type: number nullable: true default: 0 organicTraders4h: type: number nullable: true default: 0 organicTraders6h: type: number nullable: true default: 0 organicTraders12h: type: number nullable: true default: 0 organicTraders24h: type: number nullable: true default: 0 organicVolume1minUSD: type: number nullable: true default: 0 organicVolume5minUSD: type: number nullable: true default: 0 organicVolume15minUSD: type: number nullable: true default: 0 organicVolume1hUSD: type: number nullable: true default: 0 organicVolume4hUSD: type: number nullable: true default: 0 organicVolume6hUSD: type: number nullable: true default: 0 organicVolume12hUSD: type: number nullable: true default: 0 organicVolume24hUSD: type: number nullable: true default: 0 organicVolumeBuy1minUSD: type: number nullable: true default: 0 organicVolumeBuy5minUSD: type: number nullable: true default: 0 organicVolumeBuy15minUSD: type: number nullable: true default: 0 organicVolumeBuy1hUSD: type: number nullable: true default: 0 organicVolumeBuy4hUSD: type: number nullable: true default: 0 organicVolumeBuy6hUSD: type: number nullable: true default: 0 organicVolumeBuy12hUSD: type: number nullable: true default: 0 organicVolumeBuy24hUSD: type: number nullable: true default: 0 organicVolumeSell1minUSD: type: number nullable: true default: 0 organicVolumeSell5minUSD: type: number nullable: true default: 0 organicVolumeSell15minUSD: type: number nullable: true default: 0 organicVolumeSell1hUSD: type: number nullable: true default: 0 organicVolumeSell4hUSD: type: number nullable: true default: 0 organicVolumeSell6hUSD: type: number nullable: true default: 0 organicVolumeSell12hUSD: type: number nullable: true default: 0 organicVolumeSell24hUSD: type: number nullable: true default: 0 organicBuys1min: type: number nullable: true default: 0 organicBuys5min: type: number nullable: true default: 0 organicBuys15min: type: number nullable: true default: 0 organicBuys1h: type: number nullable: true default: 0 organicBuys4h: type: number nullable: true default: 0 organicBuys6h: type: number nullable: true default: 0 organicBuys12h: type: number nullable: true default: 0 organicBuys24h: type: number nullable: true default: 0 organicSells1min: type: number nullable: true default: 0 organicSells5min: type: number nullable: true default: 0 organicSells15min: type: number nullable: true default: 0 organicSells1h: type: number nullable: true default: 0 organicSells4h: type: number nullable: true default: 0 organicSells6h: type: number nullable: true default: 0 organicSells12h: type: number nullable: true default: 0 organicSells24h: type: number nullable: true default: 0 organicBuyers1min: type: number nullable: true default: 0 organicBuyers5min: type: number nullable: true default: 0 organicBuyers15min: type: number nullable: true default: 0 organicBuyers1h: type: number nullable: true default: 0 organicBuyers4h: type: number nullable: true default: 0 organicBuyers6h: type: number nullable: true default: 0 organicBuyers12h: type: number nullable: true default: 0 organicBuyers24h: type: number nullable: true default: 0 organicSellers1min: type: number nullable: true default: 0 organicSellers5min: type: number nullable: true default: 0 organicSellers15min: type: number nullable: true default: 0 organicSellers1h: type: number nullable: true default: 0 organicSellers4h: type: number nullable: true default: 0 organicSellers6h: type: number nullable: true default: 0 organicSellers12h: type: number nullable: true default: 0 organicSellers24h: type: number nullable: true default: 0 createdAt: type: string nullable: true latestTradeDate: type: string nullable: true holdersCount: type: number nullable: true description: type: string nullable: true socials: type: object properties: twitter: type: string nullable: true website: type: string nullable: true telegram: type: string nullable: true others: type: object nullable: true additionalProperties: nullable: true uri: type: string required: - twitter - website - telegram - others security: type: object nullable: true properties: buyTax: type: string nullable: true sellTax: type: string nullable: true transferPausable: type: boolean top10Holders: type: string isBlacklisted: type: boolean noMintAuthority: type: boolean balanceMutable: type: boolean lowLiquidity: type: string burnRate: type: string liquidityBurnPercentage: type: number isHoneypot: type: boolean isNotOpenSource: type: boolean renounced: type: boolean locked: type: string isWhitelisted: type: boolean isMintable: type: boolean modifyableTax: type: boolean selfDestruct: type: boolean twitterReusesCount: type: number nullable: true default: 0 twitterRenameCount: type: number nullable: true default: 0 twitterRenameHistory: type: array items: type: object properties: username: type: string lastChecked: type: string required: - username - lastChecked default: [] deployerMigrationsCount: type: number nullable: true default: 0 deployerTokensCount: type: number nullable: true default: 0 dexscreenerListed: type: boolean nullable: true default: false dexscreenerHeader: type: string nullable: true default: null dexscreenerAdPaid: type: boolean nullable: true default: false dexscreenerAdPaidDate: type: string nullable: true default: null dexScreenerEnhanced: type: object nullable: true properties: icon: type: string nullable: true header: type: string nullable: true description: type: string nullable: true links: type: array items: type: object properties: url: type: string label: type: string type: type: string required: - url default: [] isCto: type: boolean default: false timestamp: type: number nullable: true enhanced: type: boolean default: false previousEnhancements: type: array items: type: object properties: icon: type: string nullable: true header: type: string nullable: true description: type: string nullable: true links: type: array items: type: object properties: url: type: string label: type: string type: type: string required: - url default: [] isCto: type: boolean default: false timestamp: type: number nullable: true required: - icon - header - description - timestamp default: [] default: null required: - icon - header - description - timestamp dexscreenerPendingAt: type: string nullable: true default: null dexscreenerSocialPaid: type: boolean nullable: true default: false dexscreenerSocialPaidDate: type: string nullable: true default: null liveStatus: type: string nullable: true liveThumbnail: type: string nullable: true livestreamTitle: type: string nullable: true liveReplyCount: type: number nullable: true dexscreenerBoosted: type: boolean nullable: true default: false dexscreenerBoostedDate: type: string nullable: true default: null dexscreenerBoostedAmount: type: number nullable: true default: 0 trendingScore1min: type: number nullable: true default: 0 trendingScore5min: type: number nullable: true default: 0 trendingScore15min: type: number nullable: true default: 0 trendingScore1h: type: number nullable: true default: 0 trendingScore4h: type: number nullable: true default: 0 trendingScore6h: type: number nullable: true default: 0 trendingScore12h: type: number nullable: true default: 0 trendingScore24h: type: number nullable: true default: 0 isMayhemMode: type: boolean nullable: true default: null isCashbackCoin: type: boolean nullable: true default: null isAgentMode: type: boolean nullable: true default: null isOGCoin: type: boolean nullable: true default: null top10HoldingsPercentage: type: number nullable: true top50HoldingsPercentage: type: number nullable: true top100HoldingsPercentage: type: number nullable: true top200HoldingsPercentage: type: number nullable: true devHoldingsPercentage: type: number nullable: true insidersHoldingsPercentage: type: number nullable: true bundlersHoldingsPercentage: type: number nullable: true snipersHoldingsPercentage: type: number nullable: true proTradersHoldingsPercentage: type: number nullable: true freshTradersHoldingsPercentage: type: number nullable: true smartTradersHoldingsPercentage: type: number nullable: true insidersCount: type: number nullable: true bundlersCount: type: number nullable: true snipersCount: type: number nullable: true freshTradersCount: type: number nullable: true proTradersCount: type: number nullable: true smartTradersCount: type: number nullable: true freshTradersBuys: type: number nullable: true proTradersBuys: type: number nullable: true smartTradersBuys: type: number nullable: true required: - address - chainId - symbol - name - priceTokenString - approximateReserveTokenRaw - logo - bondedAt - createdAt - latestTradeDate - description - socials - security - liveStatus - liveThumbnail - livestreamTitle - liveReplyCount balance: type: number rawBalance: type: string amountUSD: type: number buys: type: number sells: type: number volumeBuyToken: type: number volumeSellToken: type: number volumeBuy: type: number volumeSell: type: number avgBuyPriceUSD: type: number avgSellPriceUSD: type: number realizedPnlUSD: type: number unrealizedPnlUSD: type: number totalPnlUSD: type: number totalFeesPaidUSD: type: number default: 0 buyFeesPaidUSD: type: number default: 0 sellFeesPaidUSD: type: number default: 0 firstDate: type: string nullable: true lastDate: type: string nullable: true labels: type: array nullable: true items: type: string default: [] required: - token - balance - rawBalance - amountUSD - buys - sells - volumeBuyToken - volumeSellToken - volumeBuy - volumeSell - avgBuyPriceUSD - avgSellPriceUSD - realizedPnlUSD - unrealizedPnlUSD - totalPnlUSD - firstDate - lastDate wallet: type: object properties: fundingInfo: type: object nullable: true properties: from: type: string nullable: true date: type: string nullable: true chainId: type: string nullable: true txHash: type: string nullable: true amount: type: string nullable: true formattedAmount: type: number nullable: true currency: type: object nullable: true properties: name: type: string symbol: type: string logo: type: string nullable: true decimals: type: number address: type: string required: - name - symbol - logo - decimals - address fromWalletLogo: type: string nullable: true fromWalletTag: type: string nullable: true fromWalletMetadata: type: object nullable: true properties: entityName: type: string nullable: true entityLogo: type: string nullable: true entityLabels: type: array items: type: string entityType: type: string nullable: true entityDescription: type: string nullable: true entityTwitter: type: string nullable: true entityWebsite: type: string nullable: true entityGithub: type: string nullable: true entityDiscord: type: string nullable: true entityTelegram: type: string nullable: true extra: type: object additionalProperties: nullable: true required: - entityName - entityLogo - entityLabels - entityType - entityDescription - entityTwitter - entityWebsite - entityGithub - entityDiscord - entityTelegram default: null required: - from - date - chainId - txHash - amount - formattedAmount - currency - fromWalletLogo - fromWalletTag entity: type: string nullable: true default: null labels: type: array items: type: string default: [] required: - data ````