Read a balance

A balance read is a free, read-only call. You do not need a private key, a wallet, or SEI for gas.

Try it live

This call runs from your browser against Sei Mainnet. It returns the balance in wei, the smallest unit of SEI. One SEI is 10¹⁸ wei.

Install

npm install viem

npm install ethers

pip install web3

The TypeScript examples use top-level await. Run them with npx tsx script.ts on Node.js 18 or later.

Read a native balance

The native balance is the amount of SEI that an address holds.

import { createPublicClient, http, formatEther } from 'viem';
import { sei } from 'viem/chains';

const client = createPublicClient({ chain: sei, transport: http() });

// Replace with any Sei EVM address
const address = '0x0000000000000000000000000000000000000000';

const wei = await client.getBalance({ address });
console.log(`${formatEther(wei)} SEI`);

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com');

// Replace with any Sei EVM address
const address = '0x0000000000000000000000000000000000000000';

const wei = await provider.getBalance(address);
console.log(`${ethers.formatEther(wei)} SEI`);

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://evm-rpc.sei-apis.com"))

# Replace with any Sei EVM address
address = "0x0000000000000000000000000000000000000000"

wei = w3.eth.get_balance(address)
print(f"{w3.from_wei(wei, 'ether')} SEI")

You are done when you see:

1384.115892177302953913 SEI

The number is illustrative. Each library returns the balance in wei: a bigint in viem and ethers, and an int in web3.py. The formatEther and from_wei(…, 'ether') helpers divide by 10¹⁸. They carry Ethereum names, but they apply to SEI because SEI also uses 18 decimals on the EVM.

EVM RPC methods take 0x addresses. If you have a sei1… address, see Accounts to find the EVM address of the same account.

Read an ERC-20 balance

A token balance lives in the token contract, so you call its balanceOf function. Then you scale the result by the token’s decimals. This example reads USDC on Sei Mainnet at 0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392, which uses 6 decimals.

import { createPublicClient, http, parseAbi, formatUnits } from 'viem';
import { sei } from 'viem/chains';

const client = createPublicClient({ chain: sei, transport: http() });

const USDC = '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392';
const address = '0x0000000000000000000000000000000000000000';
const abi = parseAbi([
  'function balanceOf(address owner) view returns (uint256)',
  'function decimals() view returns (uint8)',
]);

const [balance, decimals] = await Promise.all([
  client.readContract({ address: USDC, abi, functionName: 'balanceOf', args: [address] }),
  client.readContract({ address: USDC, abi, functionName: 'decimals' }),
]);
console.log(`${formatUnits(balance, decimals)} USDC`);

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://evm-rpc.sei-apis.com');

const USDC = '0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392';
const address = '0x0000000000000000000000000000000000000000';
const usdc = new ethers.Contract(
  USDC,
  ['function balanceOf(address owner) view returns (uint256)', 'function decimals() view returns (uint8)'],
  provider
);

const [balance, decimals] = await Promise.all([usdc.balanceOf(address), usdc.decimals()]);
console.log(`${ethers.formatUnits(balance, decimals)} USDC`);

from decimal import Decimal
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://evm-rpc.sei-apis.com"))

USDC = "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392"
address = "0x0000000000000000000000000000000000000000"
abi = [
    {"type": "function", "name": "balanceOf", "stateMutability": "view",
     "inputs": [{"name": "owner", "type": "address"}], "outputs": [{"name": "", "type": "uint256"}]},
    {"type": "function", "name": "decimals", "stateMutability": "view",
     "inputs": [], "outputs": [{"name": "", "type": "uint8"}]},
]
usdc = w3.eth.contract(address=USDC, abi=abi)

balance = usdc.functions.balanceOf(address).call()
decimals = usdc.functions.decimals().call()
print(f"{Decimal(balance) / 10**decimals} USDC")

The zero address holds no USDC, so the example prints 0 USDC. ethers prints 0.0 USDC, because formatUnits in ethers always includes a decimal place. Replace address with your own address to see a real balance.

Read many balances at once

Each read above is a separate RPC request. To read dozens of balances in one request, batch them with Multicall3, which is deployed at 0xcA11bde05977b3631167028862bE2a173976CA11 on Sei Mainnet and Sei Testnet.

Send SEI: move SEI to another address
ERC-20 interaction: token metadata, transfers, and approvals
Multicall: batch many reads into one request

Overview

Client Setup

Accounts and Transactions

Tokens

Contracts

Sei Features

Try it live

Install

Read a native balance

Read an ERC-20 balance

Read many balances at once

​Try it live

​Install

​Read a native balance

​Read an ERC-20 balance

​Read many balances at once

​Related recipes

Try it live

Install

Read a native balance

Read an ERC-20 balance

Read many balances at once

Related recipes