Fetch Balance

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

You can show a wallet’s full portfolio by using the useMultichainTokenBalances hook, which batches token balances across chains and networks in a single call.

React

import { useMultichainTokenBalances, useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { ChainEnum } from '@dynamic-labs/sdk-api-core';

const { primaryWallet } = useDynamicContext();

const { multichainTokenBalances, isLoading } = useMultichainTokenBalances({
  filterSpamTokens: true,
  requests: [
    {
      address: primaryWallet?.address || '',
      chain: ChainEnum.Evm,
      networkIds: [1, 137, 56], // Ethereum, Polygon, BNB
    },
  ],
});

Each token entry includes marketValue (USD value) and price (USD per unit), so the total portfolio value is the sum of marketValue across tokens:

React

const totalUsd = multichainTokenBalances
  ?.flatMap((chain) => chain.networks)
  .flatMap((network) => network.balances ?? [])
  .reduce((sum, token) => sum + (token.marketValue ?? 0), 0);

Native asset balance

getBalance returns the native asset only (for example ETH on Ethereum, SOL on Solana) for the wallet’s active network. For total portfolio value across tokens and chains, use useMultichainTokenBalances above.

To show the balance of just the wallet’s native asset, use the getBalance method from the wallet connector via useDynamicContext.

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core'

const { primaryWallet } = useDynamicContext()

const [balance, setBalance] = useState(null)

useEffect(() => {
  const fetchBalance = async () => {
    if (primaryWallet) {
      const value = await primaryWallet.getBalance()
      setBalance(value)
    }
  }
  fetchBalance()
}, [primaryWallet])

return <p>{balance}</p>

Last modified on October 12, 2026

Implementation Guides

SDK Reference

Recommended: JavaScript SDK with React Hooks

Native asset balance

Recommended: JavaScript SDK with React Hooks

​Native asset balance

Native asset balance