> For the complete documentation index, see [llms.txt](https://smart-tools.gitbook.io/smart-tools-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smart-tools.gitbook.io/smart-tools-docs/features/token-management/batch-query-balance.md).

# Batch Query Balance

Instantly check ETH and token balances across hundreds of wallets in seconds—completely free. Perfect for audits, airdrop tracking, and treasury management.

{% hint style="info" %}

### **Why Use Our Batch Balance Tool?**

* **100% Free** – No fees, no limits
* **Lightning Fast** – Scan hundreds of addresses at once
* **Flexible Input** – Paste manually or upload CSV/TXT files
* **Export-Ready** – Download results as CSV for reporting
  {% endhint %}

***

## **How It Works**

### **1. Select Asset to Check**

* **ETH (Default)** – Checks native balance for all addresses
* **+ ERC-20 Token** *(Optional)* – Paste a token contract to include balances

💡 *Leave the token field blank for ETH-only checks.*

### **2. Add Wallet Addresses**

**Option A: Manual Entry**

* Paste addresses (one per line):

  text

  ```
  0xAbC123...  
  0xD2F456...  
  ```

**Option B: File Upload**

* Upload **.csv/.txt** with addresses (each on a new line)

**Option C: Add Individually**

* Use the "+ Address" button for one-by-one input

***

## **Results Dashboard**

After querying, you'll see:

* **Total Addresses Checked**
* **Combined ETH Balance**
* **Combined Token Balance** (if applicable)

**Export Full Data** → Download a CSV with:

* Wallet Address
* ETH Balance
* Token Balance *(if queried)*

***

> ### **Top Use Cases**
>
> * **Airdrop Verification** – Validate recipient balances
> * **Treasury Audits** – Track team/fund wallets
> * **Token Analytics** – Monitor holder distribution
> * **Accounting** – Export for tax/reporting

### **Security Guarantee**

* **Read-Only Access** – No private keys needed
* **No Storage** – We never save your address lists
* **Direct RPC Calls** – Queries live blockchain data

***

> **Try it now →** Paste addresses or upload a file to get started!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://smart-tools.gitbook.io/smart-tools-docs/features/token-management/batch-query-balance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
