Agent Wallets

An Agent Wallet belongs to one of your customers and gives their AI agent a controlled balance it can use to make payments on their behalf. Your business decides which customers receive wallets, what each wallet is called and the spending controls that apply, while the customer owns the funds held in the wallet.

Wallets are created explicitly rather than automatically when a customer signs in or connects an AI client. Each wallet maintains its own balance, controls and funding addresses, which makes it possible for a customer to separate money by purpose without giving their agent unrestricted access to everything they hold.

Create a wallet

Create a wallet for an existing customer and give it a name that both the customer and their AI agent can understand.

curl --request POST \
  --url https://api.mitu.ai/v1/customers/cus_ds9hazr8jd3l/wallets \
  --header "x-api-key: $MITU_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Travel",
    "limits": {
      "per_payment": 25,
      "monthly": 200,
      "approve_above": 50
    }
  }'

{
  "id": "wal_fc2ff966abc04de09c22",
  "customer_id": "cus_ds9hazr8jd3l",
  "name": "Travel",
  "currency": "USDC",
  "status": "active",
  "frozen_at": null,
  "frozen_reason": null,
  "limits": {
    "per_payment": 25,
    "session": 0,
    "daily": 0,
    "monthly": 200,
    "approve_above": 50,
    "currency": "USD"
  },
  "created_at": "2026-09-11T15:01:32.760Z"
}

Parameters

The response does not include funding addresses. Read them with Get wallet addresses. See Limits and controls for how each control is enforced.

You can also issue wallets from the dashboard by opening Wallets, choosing Create wallet, selecting the customer and configuring the wallet name and controls.

Wallet creation is explicit

Creating a customer does not automatically create a wallet, and neither does signing in, connecting through MCP or asking for a balance. A customer can therefore exist without an Agent Wallet, and that is a normal account state rather than an error.

This distinction keeps wallet issuance under your control. You decide which customers should receive spending capabilities and when those wallets should be created. If a customer does not need an Agent Wallet, their customer account can continue to exist and use other parts of your product without one.

Wallet names

A wallet name is part of the customer-facing interface, not just an internal label. Customers may refer to wallets by name when instructing their AI agents, so names should be short, distinct and easy to understand in natural language. Names such as Travel, Shopping and Office are generally clearer than identifiers such as Wallet 1 or Main 2.

Wallet names are unique within a customer because an agent needs an unambiguous way to determine which balance the customer intends to use. If a customer has several wallets, the wallet name becomes particularly important when a payment is being made.

Limits

Spending controls are configured for each wallet when it is created and can determine how the wallet may be used. Limits that are omitted during creation can inherit the controls already configured for the customer, so an omitted value should not automatically be interpreted as unlimited spending.

The controls supported on the wallet are per_payment, session, daily, monthly and approve_above. All of them are enforced when the agent pays, and they can be changed later through the wallet’s policy. A wallet can also be frozen on its own.

See Limits and controls for the details.

Retrieve a customer’s wallets

Retrieve the wallets belonging to a customer through the API.

GET /v1/customers/{customer_id}/wallets

The response contains the wallets issued to that customer together with their balances, configured controls and other wallet information. A customer with no wallets should be handled as a valid result rather than as an integration failure.

What an AI agent can do

Once the customer is connected, their AI agent can use wallet capabilities made available by Mitu to inspect the wallets it can use, check balances, retrieve funding addresses and complete permitted payments. The wallet remains owned by the customer even when an AI agent is using it.

An AI agent cannot create wallets, withdraw funds, move money between wallets, change spending controls or take ownership of a wallet. Those operations remain outside the agent’s spending capabilities so that giving an agent permission to pay does not give it unrestricted control over the customer’s money.

See Wallet tools for the capabilities available to connected AI agents.

Related