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

# get_balance

> Show the cash balance available for cards.

<Note>Renamed from `get_wallet` in July 2026; the old name keeps working until August 20, 2026.</Note>

Returns the user's cash balance, provisioning the underlying account automatically on first use. Use it to check the balance before creating cards or after adding funds; the user pays in USD and the funds are held as USDC. For one card's remaining balance, use [get\_card\_balance](/companies/mcp/tools/get_card_balance) instead.

## Parameters

This tool takes no parameters.

## Returns

The cash balance and its status, plus a reminder that funds can be added with [add\_funds](/companies/mcp/tools/add_funds). While a deposit is still clearing on-chain, the response shows a separate "Confirming" amount for about a minute; do not add more funds during that window. If the user has never held a balance, the account is set up first and the response notes that it was just created.

## Example

```json theme={null}
{ "name": "get_balance", "arguments": {} }
```