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

# Wallet Balance

> Guide: understanding wallet balances

Use the wallet balance endpoint to see **how much money is available** in a managed wallet before triggering payouts.

Key fields you’ll see in responses:

* **available\_balance**: funds you can spend immediately.
* **ledger\_balance**: available balance plus pending debits/credits.
* **currency**: currency of the wallet (e.g. `NGN`).

Typical flow:

1. Call the wallet-balance endpoint with your `api-key` and `api-secret` headers.
2. Compare `available_balance` to the amount you plan to move.
3. Block or allow the transfer based on your own rules and limits.

For the exact endpoint path, headers, and JSON schema, see **API reference → Wallets → Wallet Balance**.
