# Funding and Budgets

Manage agent wallet balances and spending limits.

## How Agent Funding Works

### Two-Wallet System

```
┌─────────────────┐         ┌─────────────────┐
│  User Wallet    │ ──────> │  Agent Wallet   │
│  (Your AIOU)    │ Transfer │  (Agent's AIOU) │
└─────────────────┘         └─────────────────┘
                                     ↓
                              Pays for VPS + LLM
```

1. **User Wallet**: Your main AIOU balance
2. **Agent Wallet**: Each agent has dedicated funds
3. **Transfer**: Move AIOU from user to agent
4. **Spend**: Agent pays for its own services

## Funding an Agent

### When to Fund

* **Initial deployment**: Minimum 10 AIOU required
* **Low balance**: When agent runs low
* **Increased usage**: Before heavy workloads

### How to Fund

**Method 1: From Agent List**

1. Go to **Agents** page
2. Find your agent
3. Click **"Fund"** button
4. Enter amount
5. Confirm transfer

**Method 2: From Agent Details**

1. Open agent details page
2. Click **"Fund"** button (top right)
3. Enter amount
4. Confirm

### Transfer Modes

| Mode               | Description                        |
| ------------------ | ---------------------------------- |
| **Amount**         | Transfer specific amount           |
| **Target Balance** | Set agent wallet to specific total |

Example target balance:

* Agent has 5 AIOU
* Set target to 50 AIOU
* System transfers 45 AIOU

## Checking Balances

### User Wallet

Shown in top navigation:

```
💰 3.0000 AIOU
```

### Agent Wallet

**Agent Details Page**:

```
AIOU Balance: 3.6920
Frozen: 0.0000
Spent: 1.5580
```

| Field       | Meaning                      |
| ----------- | ---------------------------- |
| **Balance** | Available for spending       |
| **Frozen**  | Reserved for pending charges |
| **Spent**   | Total consumed lifetime      |

## Setting Budgets

Configure spending limits to control costs.

### Budget Types

| Type                | Description             |
| ------------------- | ----------------------- |
| **Daily Limit**     | Max AIOU per day        |
| **Total Limit**     | Max lifetime spending   |
| **Alert Threshold** | Warning at X% of budget |

### Setting Up

1. Go to agent details
2. Find **Budget** section
3. Set limits:
   * Daily cap
   * Total cap
   * Alert percentage
4. Save

### Budget Actions

When limit reached:

* **Alert**: Notification sent
* **Throttle**: Reduce non-essential operations
* **Stop**: Halt agent (configurable)

## Automatic Funding

Configure auto-topup (if available):

```
When agent balance < X AIOU
Transfer Y AIOU automatically
```

⚠️ **Caution**: Monitor auto-transfers to avoid overspending

## Funding Best Practices

### Initial Deployment

* Fund at least 10 AIOU (minimum)
* Recommended: 50+ AIOU for first week of operation

### Ongoing Operations

* Monitor balance every few days
* Set alerts at 20% and 10%
* Keep 7-14 days of runway

### Cost Management

* Track spending in History
* Review monthly costs
* Adjust budgets seasonally

## Low Balance Scenarios

### Warning Signs

* Dashboard shows "low balance"
* Agent status changes
* Email/notification alerts

### Recovery Steps

1. Check current balance
2. Calculate needed amount
3. Transfer from user wallet
4. Verify agent resumes

### If Balance Depletes

* LLM requests fail (402 error)
* Agent continues running (VPS billed)
* Immediate funding required

## Transfer Limits

| Limit            | Description              |
| ---------------- | ------------------------ |
| **Min transfer** | No strict minimum        |
| **Max transfer** | Your user wallet balance |
| **Frequency**    | No limits                |

## Transaction History

View all transfers:

**Platform → History**:

```
Event: AIOU TRANSFER
Direction: debit (from user)
Amount: -50.0000
Reference: agent_topup
```

## FAQ

**Q: Can I transfer AIOU between agents?** A: No. Only user wallet → own agents.

**Q: Can I withdraw from agent wallet?** A: No. AIOU flows one way: user → agent → platform services.

**Q: What happens to unused AIOU if I delete agent?** A: Currently lost. Spend down before deleting.

**Q: Why can't I fund more?** A: Check your user wallet balance. Deposit more USDT if needed.

## Next Steps

→ [Transaction History](/agos/agos-cloud/platform/history.md) to review all movements


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agos.gitbook.io/agos/agos-cloud/platform/funding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.