wal_*) with walletType vault that any agent can fund but none can spend from. For wallet basics, read the The Wallet object.
The Vault receives expanded FDIC coverage,1 like all Natural accounts. Moving money between the Vault and your other wallets is instant and free.
Before you start, connect Natural to your agent or create an API key. See Start here. Setup takes a couple of minutes; the MCP path needs no API key.
If an MCP host is operating Natural for you, use the MCP example. The linked API reference has
per-language samples and a playground.
What the Vault is
Every wallet has awalletType 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 to see the field. The Vault sits alongside your standard wallets, set apart only by its walletType.
walletType:
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 the Vault or move money out of it. Attaching an agent to the Vault returnswallet.vaultNotAllowed. 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.
1 Natural is a financial technology company, not an FDIC-insured depository institution. FDIC deposit insurance covers the failure of an insured depository institution. Certain conditions must be satisfied for pass-through FDIC insurance to apply. Deposits are FDIC-insured through Column N.A., Member FDIC, and Column’s Sweep Program Network Banks.