Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.aegisintent.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Live on Arc Testnet — The Aegis Yield system is fully operational. Agents can autonomously deposit USDC, track their appreciating aUSDC shares, and withdraw with accrued yield.

​
Autonomous Yield Generation

Aegis includes an autonomous wealth generation engine that allows AI agents to deposit their idle USDC into yield-bearing smart contract vaults on the Arc Testnet. By depositing USDC, agents receive aUSDC (Aegis USDC) shares in return. The system automatically injects real USDC yield directly into the vault onchain, constantly driving up the pricePerShare. When an agent withdraws, they trade their aUSDC shares back for more USDC than they originally deposited.

​
Smart Contract Integration

The Aegis Yield Vault is a live, onchain smart contract deployed on the Arc Testnet. Vault Contract Address: 0xAf5f79495285b1d180858a225aDE518d371e0167

​
Automatic Allowlisting

To protect the yield vault from sybil attacks and unauthorized extraction, the smart contract utilizes a strict allowlist. However, you don’t need to manage this manually! Every time a new AI agent is provisioned and securely boarded onto Aegis, the backend automatically registers and allowlists the agent’s smart wallet address onchain. This means your agents have zero friction, the moment they are created, they are already pre-approved by the vault to deposit USDC and begin earning yield autonomously.

​
How It Works

1

Check the Live Vault State

Before depositing, your agent can view the active vault APY and the current share price:
curl -X GET https://api.aegisintent.xyz/v1/actions/yield/vault \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com"
The response returns the live metrics from the smart contract:
{
  "success": true,
  "vault": {
    "address": "0xAf5f79495285b1d180858a225aDE518d371e0167",
    "totalAssets": "10000000000",
    "totalShares": "10000000000",
    "pricePerShare": "1.000000",
    "estimatedAPYPercent": 2.0
  }
}
2

Deposit USDC

Submit the deposit with an idempotency key and your agent’s nonce. Aegis will automatically approve the USDC onchain and deposit it into the vault.
curl -X POST https://api.aegisintent.xyz/v1/actions/yield/deposit \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "X-Aegis-Nonce: 0" \
  -d '{
    "amount": "20.00"
  }'
A successful deposit returns the confirmed transaction details:
{
  "success": true,
  "result": {
    "action": "YIELD_DEPOSIT",
    "vault": "0xAf5f79495285b1d180858a225aDE518d371e0167",
    "amount": "20.00",
    "txHash": "0x123abc...",
    "status": "COMPLETE"
  }
}
3

Check Agent Yield Balance

Track the exact number of aUSDC shares the agent holds and what their current USDC value is:
curl -X GET https://api.aegisintent.xyz/v1/actions/yield/balance \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com"

{
  "success": true,
  "balance": {
    "vaultAddress": "0xAf5f79495285b1d180858a225aDE518d371e0167",
    "shares": "20.00",
    "usdcValue": "20.04",
    "lockExpiresAt": "2026-05-21T13:00:00.000Z"
  }
}
4

Withdraw USDC

When ready, the agent can withdraw their aUSDC shares. The smart contract automatically exchanges them back for the original USDC plus all accrued yield.
curl -X POST https://api.aegisintent.xyz/v1/actions/yield/withdraw \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7b1c3d4e-5f6a-7b8c-9d0e-1f2a3b4c5d6e" \
  -H "X-Aegis-Nonce: 1" \
  -d '{
    "amount": "20.00"
  }'
A successful withdrawal returns:
{
  "success": true,
  "result": {
    "action": "YIELD_WITHDRAW",
    "vault": "0xAf5f79495285b1d180858a225aDE518d371e0167",
    "amount": "20.00",
    "txHash": "0x456def...",
    "status": "COMPLETE"
  }
}

​
Endpoint Parameters

FieldTypeRequiredEndpointDescription
amountstringYesdepositAmount of USDC to deposit (e.g. "20.00")
amountstringYeswithdrawAmount of aUSDC shares to withdraw (e.g. "20.00")

​
Auto-Compounding

The yield distribution system runs fully autonomously in the background. Because yield is injected directly into the smart contract and the math scales mathematically based on total assets, the system effectively auto-compounds without requiring the agent to manually claim rewards or reinvest!
Always fetch GET /v1/actions/nonce before executing a deposit or withdraw. These are state mutating financial actions and strictly enforce Aegis’s non repeating nonce protection.

​
Multi-Protocol Yield

Beyond the Aegis aUSDC Vault, agents can also allocate capital into Synthra V3 concentrated liquidity positions for potentially higher returns. The Wealth Engine provides a multiYield endpoint that splits a single deposit across both protocols in an atomic action: 
curl -X POST https://api.aegisintent.xyz/v1/actions/wealth/multiYield \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: c9d8e7f6-a5b4-3c2d-1e0f-9a8b7c6d5e4f" \
  -H "X-Aegis-Nonce: 2" \
  -d '{
    "amountUsdc": "100.00",
    "aegisWeight": 60,
    "synthraWeight": 40
  }'
To manually close a Synthra V3 position and collect accrued fees, use the Synthra V3 Withdraw endpoint. For full details on limit orders, DCA schedules, and portfolio metrics, see the Wealth Engine documentation.