> For the complete documentation index, see [llms.txt](https://toroforges-organization.gitbook.io/toroforge-collective/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://toroforges-organization.gitbook.io/toroforge-collective/getting-started/sdks/javascript/token-and-balances.md).

# Token & Balances

The ToroForge SDK provides simple, secure methods to retrieve wallet balances across different supported currencies on the **Toronet blockchain**.

Supported tokens:

* **NGN** (Naira – fiat-backed)
* **USD** (US Dollar – fiat-backed)
* **ToroG** (Toronet’s native token)

***

### 📦 Get Wallet Balance

To get a wallet’s full balance breakdown (NGN, USD, ToroG):

```ts
import { getBalance } from 'torosdk';

const balances = await getBalance({
  address: '0xYourWalletAddress',
});

console.log(balances);
/*
{
  ngnBalance: '1000',
  usdBalance: '25.50',
  toroGBalance: '430'
}
*/
```

Returned object includes:

* `ngnBalance`: Naira balance
* `usdBalance`: USD balance
* `toroGBalance`: Native ToroG token amount

***

### 📊 Response Format

```ts
{
  ngnBalance: string;
  usdBalance: string;
  toroGBalance: string;
}
```

Note: All amounts are returned as **strings**, already normalized for display (i.e. not in smallest unit like wei).

***

### 🧩 Use Cases

You can use this method to:

* Display balances on a user dashboard
* Validate available funds before initiating a transaction
* Refresh balances after a fiat deposit or on-chain token transfer

***

### ⚠️ Important Notes

* Ensure the `address` passed in is a valid Toronet address.
* Fiat-backed tokens like **NGN** and **USD** require successful KYC verification for high-volume usage.
* For real-time updates, consider calling this method after:
  * Successful deposits
  * Transfers between wallets
  * KYC approval confirmation

***

### 🔗 Related Docs

* [Fiat Deposit & Verification](https://chatgpt.com/c/deposits.md)
* [KYC & Identity](https://chatgpt.com/c/kyc.md)
* [Transfers](https://chatgpt.com/c/transfers.md)