<!-- ZenPays documentation · https://docs.zenpayz.com/docs/reference/objects/wallet-balance -->

# The WalletBalance object

Represents the balance of a merchant's wallet for a specific currency. The wallet balance is divided into different categories to help understand available and committed funds.

## Fields

<ParamTable
  label="Field"
  rows={[
    { name: "currency", type: "string", required: true, desc: "Three-letter ISO currency code" },
    { name: "available", type: "number", required: true, desc: "Amount available for withdrawal or payout" },
    { name: "pending", type: "number", required: true, desc: "Amount pending from recent transactions (not yet available)" },
    { name: "reserved", type: "number", required: true, desc: "Amount reserved for pending payouts or refunds" },
    { name: "total", type: "number", required: true, desc: "Total balance (available + pending + reserved)" },
  ]}
/>

## Example

```json
{
  "currency": "USD",
  "available": 1,
  "pending": 1,
  "reserved": 1,
  "total": 5000
}
```

## Usage

```typescript
const balances = await client.wallet.getBalances();
const usdBalance = balances.find(b => b.currency === 'USD');
console.log(`Available: ${usdBalance.available}, Pending: ${usdBalance.pending}`);
```