How to Get Native Token Balances for EOAs and Smart Accounts

Introduction

In this tutorial, you’ll learn how to retrieve native token balances (like ETH, MATIC, or BNB) for any wallet address using the Moralis API. This works for both externally owned accounts (EOAs) and smart contract wallets like Safe or Argent. We’ll use the following Moralis API endpoint:

Get Native Balance - Fetch the native token balance for any wallet

Prerequisites

Node.js v18+ installed
A Moralis API key (get one free)

Step 1: Set Up Your Project

Create a new directory for your project and initialize it:

mkdir get-native-balance && cd get-native-balance
npm init -y

Step 2: Create the Script

Create a file called index.js and add the following code:

// index.js
const API_KEY = 'YOUR_API_KEY';
const WALLET_ADDRESS = '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'; // Vitalik's wallet

async function getNativeBalance() {
  const response = await fetch(
    `https://deep-index.moralis.io/api/v2.2/${WALLET_ADDRESS}/balance?chain=eth`,
    {
      headers: {
        'X-API-Key': API_KEY,
      },
    }
  );

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

getNativeBalance();

Replace YOUR_API_KEY with your actual Moralis API key.

Step 3: Run the Script

Execute the script to fetch the native balance:

node index.js

Example Response

{
  "balance": "2847583920000000000000"
}

Understanding the Response

Field	Description
`balance`	The native token balance in wei (smallest unit)

To convert to a human-readable format, divide by 10^18:

const balanceInEth = Number(data.balance) / 1e18;
console.log(`Balance: ${balanceInEth} ETH`);

Next Steps

Get Token Balances - Fetch ERC20 token balances
Get Multi-Chain Activity - See activity across chains

How to Get Internal Transactions for a Wallet Address How to Get Multi-Chain Activity for a Wallet Address

⌘I

Introduction

Getting Started

Pricing & Resources

Tutorials & Guides

How to Get Native Token Balances for EOAs and Smart Accounts

Introduction

Prerequisites

Step 1: Set Up Your Project

Step 2: Create the Script

Step 3: Run the Script

Example Response

Understanding the Response

Next Steps

​Introduction

​Prerequisites

​Step 1: Set Up Your Project

​Step 2: Create the Script

​Step 3: Run the Script

​Example Response

​Understanding the Response

​Next Steps

Introduction

Prerequisites

Step 1: Set Up Your Project

Step 2: Create the Script

Step 3: Run the Script

Example Response

Understanding the Response

Next Steps