Fetch & Display Balance

React

You can show the balance of the primary wallet by using the useDynamicContext hook and the getBalance method from the wallet connector.

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>

React Native

React Native provides access to wallet balances through the dynamicClient.wallets.getBalance() method. You can get the balance for the primary wallet or any specific wallet instance.

React Native

import { dynamicClient } from '<path to client file>';

// Get balance for the primary wallet
const primary = dynamicClient.wallets.primary;
if (primary) {
  const { balance } = await dynamicClient.wallets.getBalance({ wallet: primary });
  // e.g. set state with balance
}

This approach gives you direct access to wallet balances while maintaining consistency with the React Native SDK patterns.

Swift

Swift provides access to wallet balances through the wallet instance methods. You can get the balance for any initialized wallet instance.

Swift

// Assuming you have an initialized EthereumWallet instance
do {
    let balanceWei = try await ethereumWallet.getBalance(.Latest)
    let etherValue = Double(String(balanceWei)) ?? 0.0
    let balanceEth = etherValue / pow(10.0, 18.0)
    print(String(format: "Balance: %.6f ETH", balanceEth))
} catch {
    print("Failed to get balance: \(error)")
}

This approach gives you direct access to wallet balances while maintaining consistency with the Swift SDK patterns.

Flutter

Flutter provides access to wallet balances through the DynamicSDK.instance.wallets.getBalance() method. You can get the balance for any wallet instance.

Flutter

// Assuming you have a BaseWallet instance (e.g., user's primary wallet)
final result = await DynamicSDK.instance.wallets.getBalance(wallet: wallet);
final balance = result.balance; // string balance (chain native units)
// e.g. setState(() { _balance = balance; });

This approach gives you direct access to wallet balances while maintaining consistency with the Flutter SDK patterns.

Multichain Balances

For applications that need to fetch token balances across multiple blockchain networks simultaneously, Dynamic provides a getMultichainBalances method. This is useful for displaying comprehensive portfolio views or checking balances across different chains without making separate API calls.

React

In React, you can use the useMultichainTokenBalances hook to fetch balances across multiple chains:

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
    },
  ],
});

React Native

In React Native, use the getMultichainBalances method on the wallets module:

React Native

import { dynamicClient } from '<path to client file>';
import { ChainEnum } from '@dynamic-labs/sdk-api-core';

const wallet = dynamicClient.wallets.primary;

if (wallet) {
  const balances = await dynamicClient.wallets.getMultichainBalances({
    balanceRequest: {
      filterSpamTokens: true,
      balanceRequests: [
        {
          address: wallet.address,
          chain: ChainEnum.Evm,
          networkIds: [1, 137, 56], // Ethereum, Polygon, BNB
        },
      ],
    },
  });
}