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

# Vault

> A reserve wallet agents can fund but never spend from

The Vault is a reserve wallet that no agent can spend from. It keeps money separate from your day-to-day agent activity. Anyone can move money in, including agents, but no agent can take money out.

<Snippet file="shared/prerequisites.mdx" />

<Snippet file="shared/mcp-callout.mdx" />

## What the Vault is

Every wallet has a `walletType` of `standard` or `vault`. A standard wallet is the everyday, spendable one. The Vault is the locked-down reserve.

List your wallets with [`GET /wallets`](/api-reference/wallets/list-wallets) to see the field. The Vault sits alongside your standard wallets, set apart only by its `walletType`.

<CodeGroup>
  ```python Python theme={null}
  from naturalpay import Natural

  client = Natural()
  wallets = client.wallets.list()
  for wallet in wallets.data:
      print(wallet.id, wallet.attributes.display_name, wallet.attributes.wallet_type)
  ```

  ```typescript TypeScript theme={null}
  import Natural from "@naturalpay/sdk";

  const client = new Natural();
  const wallets = await client.wallets.list();
  for (const wallet of wallets.data) {
    console.log(wallet.id, wallet.attributes.displayName, wallet.attributes.walletType);
  }
  ```

  ```bash CLI theme={null}
  natural wallets list
  ```

  ```text MCP theme={null}
  List my Natural wallets and show each one's type and balance.
  ```

  ```bash cURL theme={null}
  curl https://api.natural.com/wallets \
    -H "Authorization: Bearer $NATURAL_API_KEY"
  ```
</CodeGroup>

## How the Vault differs

The Vault behaves differently from a standard wallet in three ways.

**1. You cannot create one through the API.** The Vault is provisioned once after onboarding.

**2. Agents cannot be attached to Vault or move money out of it.** Agents can still fund the Vault by transferring in from a standard wallet.

**3. It cannot be your default wallet.** Keep a standard wallet as your default so calls that omit `walletId` resolve somewhere spendable.
