Moralis icon

Moralis

Interact with Moralis Web3 APIs for blockchain data, NFTs, tokens, and DeFi

Actions19

Wallet → Get Native Balance

AI-generated

Overview

This node interacts with the Moralis Web3 API to retrieve the native token balance of a specified wallet address on a selected blockchain network. It is useful for users who want to check the balance of the main cryptocurrency (e.g., ETH on Ethereum) held by a wallet across various supported chains such as Ethereum, Polygon, BSC, and others.

Use Case Examples

  1. Checking the ETH balance of a wallet on the Ethereum mainnet.
  2. Retrieving the native token balance of a wallet on the Polygon network for portfolio tracking.

Properties

Name Meaning
Chain The blockchain network to query for the wallet's native balance. Options include Ethereum, Polygon, BSC, Arbitrum, Avalanche, Base, and Optimism.
Wallet Address The wallet address whose native token balance is to be retrieved. This is a required string input.
Additional Fields Optional parameters to customize the request, including limit on results, pagination cursor, whether to include metadata, and number format (decimal or hex).

Output

JSON

  • balance - The native token balance of the wallet in the specified format.
  • operation - The operation performed, here it is 'getNativeBalance'.
  • resource - The resource type, here it is 'wallet'.
  • chain - The blockchain network on which the balance was queried.
  • timestamp - The timestamp when the data was retrieved.

Dependencies

  • Moralis Web3 API
  • An API key credential for Moralis API

Troubleshooting

  • Ensure the wallet address is valid and correctly formatted (e.g., starts with '0x').
  • Verify that the selected blockchain network (chain) is supported and correctly specified.
  • Check that the Moralis API key credential is correctly configured and has sufficient permissions.
  • If the API returns 'No data found', verify that the wallet address has a balance on the specified chain.
  • Handle API rate limits or network errors by enabling 'Continue On Fail' to avoid workflow interruption.

Links

Discussion