This API doesn't retrieve a list of address balances. To retrieve the balance of an entire wallet, use the Retrieve a wallet balance API.
For Stellar, Cosmos, and Ripple chains, which only have a single address per wallet, use the Retrieve a wallet balance API instead.

API use cases

You can use the API to retrieve the balance of either native coins or tokens from a single address or a list of addresses, as explained in the following use cases.

Retrieve native coin balance

• Single address query: You can retrieve the native coin balance for a single address, using the following request body.
  JSON

  {
      "wallet":{
          "coin": "eth",
          "walletId":1
      },
      "getAddressBalanceOption":{
          "address":"0xec69e15335c1f7a0a4733b504abc327f81baf8b5"
      }
  }

• Paginated address query: You can retrieve native coin balance for a paginated list of addresses, using the following request body.
  JSON

  {
      "wallet":{
          "coin": "eth",
          "walletId":1
      },
      "getAddressBalanceOption":{
         "pagination":{
                      "pageNumber":1,
                      "pageSize":50
                  }
      }
  }

Retrieve token balance

• Single address query - You can retrieve the token balance for a single address, using the following request body. The body includes an additional parameter isTokenBalance. If you set its value to true, the API retrieves the token balance.
  JSON

  {
      "wallet":{
          "coin": "eth",
          "walletId":1
      },
      "getAddressBalanceOption":{
          "address":"0x4014c023192ef37a91adcea4ac2fdd90914bd76f",
          "isTokenBalance":true
      }
  }

• Paginated address query - You can retrieve token balance for a paginated list of addresses, using the following request body. The body includes an additional parameter isTokenBalance. If you set its value to true, the API retrieves the token balance.
  JSON

  {
      "wallet":{
          "coin": "eth",
          "walletId":1
      },
      "getAddressBalanceOption":{
          "pagination":{
                      "pageNumber":1,
                      "pageSize":10
                  },
          "isTokenBalance":true
      }
  }