Skip to main content
GET
/
wallets
/
balances
Get native balance for a set of wallets
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/wallets/balances \
  --header 'X-API-Key: <api-key>'
[
  {
    "chain": "eth_mainnet",
    "chain_id": "2",
    "total_balance": "57499206466583095",
    "block_number": "123456789",
    "block_timestamp": "0.057",
    "total_balance_formatted": "123456789",
    "wallet_balances": [
      {
        "address": "0x123",
        "balance": "28499206466583095",
        "balance_formatted": "0.0285"
      }
    ]
  }
]
Endpoint cost: 10 CUs per wallet. Learn more about compute units.

Authorizations

​
X-API-Key
string
header
default:test
required

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

​
to_block
number

The block number on which the balances should be checked

​
wallet_addresses
string[]
required

The addresses to get metadata for

Maximum array length: 25

Response

200 - application/json

Returns a collection of balances

​
chain
string
required

The chain

Example:

"eth_mainnet"

​
chain_id
string
required

The chain id

Example:

"2"

​
total_balance
string
required

The total balances for all the walttes

Example:

"57499206466583095"

​
block_number
string
required

The block Number

Example:

"123456789"

​
block_timestamp
string
required

The block timestamp

Example:

"0.057"

​
total_balance_formatted
string
required

The total balances for all the walttes formatted

Example:

"123456789"

​
wallet_balances
object[]
required