> For the complete documentation index, see [llms.txt](https://docs.tajirchain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tajirchain.com/api-documentation/block-explorer-api/address-and-balance-queries.md).

# Address & Balance Queries

### **Get Native Balance**

**Request**

```
https://tajir-chain.gitbook.io/tajir_chain-docs/api-documentation/block-explorer-api/address-and-balance-queries
```

**Parameters**

| Name    | Type         | Required | Description             |
| ------- | ------------ | -------- | ----------------------- |
| address | string (0x…) | Yes      | Wallet address to query |

**Sample Response**

```json
{
  "status": "1",
  "message": "OK",
  "result": "2500000000000000000"
}
```

`result` is returned in **wei**.

### **Get Token Balance (ERC-20)**

**Request**\
\
GET https\://\<explorer-url>/api?module=account\&action=tokenbalance\&contractaddress=\<token>\&address=\<user>

**Parameters**

| Name            | Type         | Required | Description                   |
| --------------- | ------------ | -------- | ----------------------------- |
| contractaddress | string (0x…) | Yes      | ERC-20 token contract address |
| address         | string (0x…) | Yes      | User wallet address           |

**Sample Response**

```json
{
  "status": "1",
  "message": "OK",
  "result": "150000000"
}
```

Values are returned in **raw token units**.\
Convert using the token’s **decimals**.

### **Notes**

* All balances are returned in **wei** or **raw token units**.
* Works with every ERC-20 token deployed on Tajir.
* Use token `decimals` to format values correctly.
* Addresses should be valid **0x-prefixed** hex strings.