> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peaq.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Checking Balances

The following explains how to retrieve wallet balances on the peaq network using `ethers.js`. Developers can often reuse ethers-based approaches with the right configurations.
If direct on-chain queries are difficult, we'll also explore how to fall back to `peaq.subscan.io`, a web-based explorer that allows you to look up balances via an HTTPS GUI.

## Prerequisites

* Basic understanding of JavaScript and Node.js.
* You have `ethers.js` installed and know how to initialize a provider.
* Possess a target wallet address for which you want to check the balance.
* Have access to a running peaq node's RPC endpoint or a compatible provider.
* Understand how to use peaq.subscan.io as a fallback.

## Instructions

### 1. Set Up Your Environment:

Ensure you have `node` and `npm` installed, then run:

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
npm install ethers
```

### 2. Initialize the Provider:

In your JavaScript file (e.g., `checkBalance.js`), import **ethers** and instantiate a provider. Point it to the RPC endpoint of the peaq network you're connecting to (this might be a testnet or mainnet endpoint—adjust accordingly):

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
import { ethers } from "ethers";

// Recommended / Example endpoint: replace with your chosen peaq RPC URL
const peaqProvider = new ethers.JsonRpcProvider("https://quicknode.peaq.xyz");
```

### 3. **Fetch the Wallet Balance**:

Use the provider's `getBalance` method, passing in the wallet address. The address should be an Ethereum-compatible format (e.g., 0x...):

```javascript theme={"theme":{"light":"github-light-default","dark":"github-dark"}}
async function getPeaqBalance(address) {
    try {
        const balanceBigInt = await peaqProvider.getBalance(address);
        const balanceEth = ethers.formatEther(balanceBigInt);
        console.log(`Balance of ${address}: ${balanceEth} PEAQ`);
    } catch (error) {
        console.error('Error fetching balance:', error);
        console.log('Falling back to peaq.subscan.io...');
    }
}

// Example usage:
const myAddress = "0xYourPeaqAddress";
getPeaqBalance(myAddress);
```

### 4. Fallback to peaq.subscan.io

If the direct query via ethers fails (due to network incompatibilities at the time of querying), you can manually check the balance using the peaq Subscan explorer:

* Navigate to: [peaq Subscan](https://peaq.subscan.io/) (mainnet) , [agung Subscan](https://agung-testnet.subscan.io) (testnet)
* Enter the **wallet address** into the search bar.
* Press "Enter" or click the search icon.
* View the displayed account information and check the reported **balance**.

### 5. Interpreting the Results

Whether you retrieved the balance programmatically via `ethers.js` or via `peaq.subscan.io`, you'll see the current token holdings associated with that address.
Make sure you understand the units (often the smallest unit might be displayed, and you may need to convert them to a more human-readable format).

## Summary

Checking **wallet balances** on the peaq network can be attempted through `ethers.js` if the network is EVM-compatible and you have the correct provider endpoint.
In the event of issues, the `peaq.subscan.io` explorer provides a simple GUI fallback. By combining these approaches, developers and users can confidently monitor
and verify the holdings in their peaq wallets.