Getting Native Balance

For most apps, prefer getMultichainTokenBalances — it batches token balances across chains, networks, and addresses in a single call. Reach for getNativeBalance only when you specifically need the native gas balance via RPC on the active network.

You can get the native gas balance in the active network of the wallet account by calling the getNativeBalance function. This goes directly to the chain via RPC. If you wish to get token balances for one chain (one or more networks of that chain), use getTokenBalances. For balances across multiple chains, use getMultichainTokenBalances instead.

Usage

JavaScript
React

import { getNativeBalance } from '@dynamic-labs-sdk/client';

const { balance } = await getNativeBalance({ walletAccount });
console.log(balance);

import { getNativeBalance } from '@dynamic-labs-sdk/client';
import { useState, useEffect } from 'react';

function WalletBalance({ walletAccount }) {
  const [balance, setBalance] = useState<string | null>(null);

  useEffect(() => {
    getNativeBalance({ walletAccount }).then(({ balance }) => setBalance(balance));
  }, [walletAccount]);

  return <p>Balance: {balance ?? '…'}</p>;
}

Getting Multichain Token Balances - Recommended default for token balances across chains
Getting Token Balances - Token balances for a single chain (one or more networks)
Getting the Wallet Account Given an Address and Chain
Getting Active Network
Switching Active Network

Get Balances for All WalletsUse getMultichainTokenBalances to fetch token holdings across every connected wallet in a single API call.

⌘I

Documentation Index

​Usage

​Related functions

Usage

Related functions