# Agent wallet: one prepaid balance your AI agent spends from

A wallet for AI agents is money you set aside once that an agent spends call by call, inside limits you set. On looot it is one prepaid USD balance for 4,100+ data APIs from 310+ providers. Each run holds its price first, settles the real cost and gives back the rest.

## How looot's agent wallet works

- 1. Top up: Add credit by card on Stripe's hosted Checkout page, from the dashboard or from a link your agent asks for. The minimum shows on the form. Source: https://docs.looot.ai/money/top-up
- 2. Agent calls: Your agent finds a job in the catalog, reads its price and runs it. Every paid run, from the CLI, the API or MCP, draws from the same balance. Source: https://docs.looot.ai/money
- 3. Hold: Before the provider is called, the most the run can cost moves from available to reserved. If the balance cannot cover it, the run is refused with a top-up link and nothing is charged. Source: https://docs.looot.ai/money/holds
- 4. Settle or refund: When the provider answers, the real cost is charged and the rest of the hold goes back to your balance. A run that fails at the provider is charged $0. Source: https://docs.looot.ai/money/holds

## Spend controls

- A monthly spending limit per API key: In Settings, API keys, give each key its own monthly spending limit. When a key reaches it, the next run is refused before any provider is called, at $0, with key_spend_limit_reached. Source: https://docs.looot.ai/reference/integrate
- The balance is the ceiling: An agent can only spend what you added. A run whose hold the balance cannot cover is refused with insufficient_balance and a Stripe link for you to pay. Source: https://docs.looot.ai/money/pay-from-your-agent
- A cap on a route's hold: Set fallback.maxCostUsd on a run and it caps the hold the route can place. A provider priced above what is left of the cap is skipped. Source: https://docs.looot.ai/money/cost-cap
- The price before the call: inspect returns the price basis and the most one call can cost. run shows the quoted price before it executes. Source: /pricing
- Calls on your own provider key: A call on a provider key you connected is billed by that provider to your own account. looot adds no markup, and on standard pricing it holds and charges $0 from your balance. Source: /pricing
- Refused calls cost nothing: Bad input, too little balance or a key at its spending limit: the run is refused before it starts and nothing is charged. Source: https://docs.looot.ai/money

## What it is not

- It is a prepaid USD balance, not a crypto wallet. You need no stablecoins and no blockchain account, and looot does not take x402 payments today.
- It is not a card. It cannot pay at a shop's checkout; it pays for data calls in the looot catalog.
- It is not a subscription. There is no monthly fee, and credit you do not spend stays on the balance.

## Worked example

One work email from Hunter (catalog row hunter-email-finder, a flat price per call). Its live price is on https://looot.ai/public-catalog/hunter-email-finder. The run holds that price, Hunter answers, and the same price is charged; Hunter bills a search that finds no email at the same price, as the row says. If Hunter fails or times out, $0 is charged and the hold returns. An API key with a monthly limit of $10 stops at the limit with key_spend_limit_reached.

## Set it up

- 1. Connect your agent: Paste one line into the agent you already use, or follow the steps for your client on the setup page.
- 2. Sign in and top up: Approve the sign-in in your browser, then add credit by card on Stripe.
- 3. Set a limit, then ask: For a headless agent, create an API key with a monthly spending limit. Then ask for the first job.
- One line for the agent: set up https://looot.ai/skill.md
- Steps per agent client: https://looot.ai/setup

## FAQ

- What is an agent wallet? An agent wallet is money set aside for an AI agent to spend on its own, inside limits a person sets. On looot it is one prepaid USD balance that pays for every data call the agent makes, with a hold on each run and a monthly spending limit per API key.
- How is a wallet for AI agents different from giving the agent a card? With a prepaid balance the agent sees the price first, each run holds that amount, and it can never spend more than you added. A card can pay at a shop's checkout, which the looot balance cannot.
- Can an AI agent wallet overspend? No. A run needs a hold the balance can cover, so the agent spends at most what you added. A monthly spending limit on each API key adds a cap per key, and fallback.maxCostUsd caps the hold a route can place.
- Is looot a crypto wallet? No. looot is a prepaid USD balance that you top up by card on Stripe. It holds no crypto, takes no stablecoins and does not answer x402 payments today.
- How do I top up my agent's balance? From the dashboard, or ask your agent: the top_up tool returns a Stripe Checkout link that you pay by card. The minimum shows on the form and in the balance answer. Credit lands once Stripe confirms the payment.
- Do calls on my own provider key use the balance? On standard pricing, no. A call on a provider key you connected is billed by that provider to your account, and looot holds and charges $0 for it. Calls on looot's keys draw from the balance at the provider's price plus a disclosed fee, shown before the run.

## For agents

The money facts behind the page, for an agent deciding how to fund its runs.

- **balance**: prepaid, USD, one per workspace
- **top-up**: card on Stripe Checkout; minimum in GET /v1/balance as topUpLink.minimumUsd
- **lifecycle**: hold -> settle real cost -> rest of the hold returns
- **per-key limit**: monthly, Settings > API keys; refusal code key_spend_limit_reached
- **route hold cap**: fallback.maxCostUsd caps the hold a fallback route can place
- **own provider key**: billed by the provider; $0 from the balance on standard pricing
- **payment rails**: card through Stripe hosted Checkout
