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

# get_balance

> Get your total wallet balance.

The `get_balance` tool returns your total USDC balance across all supported networks.

Equivalent CLI command: `npx agentcash balance`

## Parameters

This tool takes no parameters.

## Response

<ResponseField name="balance" type="number">
  Total USDC balance across all supported networks.
</ResponseField>

## Behavior

* Creates the wallet automatically at `~/.agentcash/wallet.json` if one does not exist
* Aggregates balances across all supported payment networks
* Use this before paid API calls to confirm that funds are available

## Example

Ask your agent:

> What is my AgentCash balance?