> ## 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 Holdings > Retrieve current wallet token holdings with camelCase balances, uppercase USD fields, chainBalances, enriched token details, and optional POST filters. ## OpenAPI ````yaml get /2/wallet/holdings 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: V2 - Prediction Markets description: >- Polymarket markets/events, wallet positions, and the full execution stack (auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy, deposit/withdraw, redeem). Alpha — see /api/2/pm/*. - 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/holdings: get: tags: - V2 - Wallet summary: Get Wallet Holdings description: >- Fetch wallet holdings with camelCase portfolio fields and enriched token details. Use POST for RAM filters on token fields. parameters: - schema: anyOf: - type: string - type: number - type: boolean description: Wallet address required: false description: Wallet address name: wallet in: query - schema: anyOf: - type: string - type: number - type: boolean description: Comma-separated wallet addresses required: false description: Comma-separated wallet addresses name: wallets in: query - schema: anyOf: - type: string - type: number - type: boolean description: Portfolio ID required: false description: Portfolio ID name: portfolio in: query - schema: anyOf: - type: string - type: number - type: boolean description: Comma-separated blockchain IDs required: false description: Comma-separated blockchain IDs name: blockchains in: query - schema: anyOf: - type: string - type: number - type: boolean description: Filter by specific asset required: false description: Filter by specific asset name: asset in: query - schema: anyOf: - type: string - type: number - type: boolean description: Start date required: false description: Start date name: from in: query - schema: anyOf: - type: string - type: number - type: boolean description: End date required: false description: End date name: to in: query - schema: anyOf: - type: string - type: number - type: boolean description: Portfolio display settings required: false description: Portfolio display settings name: portfolio_settings in: query - schema: anyOf: - type: string - type: number - type: boolean description: Include unlisted assets required: false description: Include unlisted assets name: unlistedAssets in: query - schema: anyOf: - type: string - type: number - type: boolean description: Time period required: false description: Time period name: period in: query - schema: anyOf: - type: string - type: number - type: boolean description: Data accuracy level required: false description: Data accuracy level name: accuracy in: query - schema: anyOf: - type: string - type: number - type: boolean description: Include testnet data required: false description: Include testnet data name: testnet in: query - schema: anyOf: - type: string - type: number - type: boolean description: Minimum liquidity threshold in USD required: false description: Minimum liquidity threshold in USD name: minLiquidity in: query - schema: anyOf: - type: string - type: number - type: boolean description: Filter spam tokens required: false description: Filter spam tokens name: filterSpam in: query - schema: anyOf: - type: string - type: number - type: boolean description: Include PnL data required: false description: Include PnL data name: pnl in: query - schema: anyOf: - type: string - type: number - type: boolean required: false name: rpc in: query responses: '200': description: Wallet holdings response content: application/json: schema: type: object properties: data: type: object properties: totalWalletBalanceUsd: type: number wallets: type: array items: type: string holdings: type: array items: 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 migrating: type: boolean 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 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 isFreezable: type: boolean balanceMutable: type: boolean lowLiquidity: type: string burnRate: type: string liquidityBurnPercentage: type: number transferTax: type: string nullable: true 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 securityScore: type: number nullable: true default: null securityScoreUpdatedAt: type: string nullable: true default: null 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 surgeScore: type: number nullable: true default: null 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 amount: type: number amountUsd: type: number allocation: type: number priceUsd: type: number priceChange24h: type: number liquidityUsd: type: number marketCapUsd: type: number crossChainBalances: type: object additionalProperties: type: object properties: amount: type: number amountRaw: type: string chainId: type: string address: type: string required: - amount - amountRaw contractBalances: type: array items: type: object properties: chainId: type: string address: type: string amount: type: number amountRaw: type: string amountUsd: type: number nullable: true decimals: type: number liquidityUsd: type: number nullable: true priceUsd: type: number nullable: true tokenType: type: string nullable: true enum: - '2020' - '2022' - erc20 - trc10 - trc20 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 isFreezable: type: boolean balanceMutable: type: boolean lowLiquidity: type: string burnRate: type: string liquidityBurnPercentage: type: number transferTax: type: string nullable: true isHoneypot: type: boolean isNotOpenSource: type: boolean renounced: type: boolean locked: type: string isWhitelisted: type: boolean isMintable: type: boolean modifyableTax: type: boolean selfDestruct: type: boolean frozen: type: boolean lamports: type: string nullable: true tokenAccount: type: string nullable: true required: - chainId - address - amount - amountRaw - decimals wallets: type: array items: type: string required: - token - amount - amountUsd - allocation - priceUsd - priceChange24h - liquidityUsd - marketCapUsd - crossChainBalances - contractBalances - wallets holdingsCount: type: number balancesLength: type: number required: - totalWalletBalanceUsd - wallets - holdings - holdingsCount - balancesLength backfillStatus: type: string enum: - processed - processing - pending required: - data ````