Version: 2.2

Get native balance for multiple wallets

GEThttps://deep-index.moralis.io/api/v2.2/wallets/balances

Get the native balances for a set of specific addresses

QUERY PARAMS

chainstring

The chain to query

to_blocknumber

The block number on which the balances should be checked

wallet_addressesarrayrequired

The addresses to get metadata for (max 25 addresses)

Responses

200 Returns a collection of balancesarray

chainstringrequired

The chain

chain_idstringrequired

The chain id

total_balancestringrequired

The total balances for all the walttes

block_numberstringrequired

The block Number

block_timestampstringrequired

The block timestamp

total_balance_formattedstringrequired

The total balances for all the walttes formatted

wallet_balancesarrayrequired

addressstringrequired

address

balancestringrequired

balance

balance_formattedstringrequired

balance formatted

API KEY

Node.js
Python
cURL
Go
PHP

import Moralis from 'moralis';

try {
  await Moralis.start({
    apiKey: "YOUR_API_KEY"
  });

  const response = await Moralis.EvmApi.balance.getNativeBalancesForAddresses({
    "chain": "0x1"
  });

  console.log(response.raw);
} catch (e) {
  console.error(e);
}

from moralis import evm_api

api_key = "YOUR_API_KEY"

params = {
  "chain": "eth"
}

result = evm_api.balance.get_native_balances_for_addresses(
  api_key=api_key,
  params=params,
)

print(result)

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/wallets/balances?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/wallets/balances?chain=eth"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/wallets/balances?chain=eth', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

[
  {
    "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"
      }
    ]
  }
]

Get native balance for multiple wallets

Don't have an API key yet?