# Aegis ## Docs - [Best Practices](https://docs.aegisintent.xyz/advanced/best-practices.md): Recommended patterns for building reliable AI agent integrations with Aegis - [Error Handling](https://docs.aegisintent.xyz/advanced/error-handling.md): Understanding Aegis error responses and how to handle them - [Glossary](https://docs.aegisintent.xyz/advanced/glossary.md): Key terms and definitions used throughout the Aegis documentation - [Idempotency](https://docs.aegisintent.xyz/advanced/idempotency.md): Preventing duplicate transactions with idempotency keys - [Skill Discovery](https://docs.aegisintent.xyz/advanced/skill-discovery.md): How agents discover and evaluate x402-compatible API services - [Webhooks](https://docs.aegisintent.xyz/advanced/webhooks.md): Receiving real time notifications for transaction events - [Agent Skill File](https://docs.aegisintent.xyz/agent-skill.md): The primary starting point for importing Aegis knowledge into your AI agent - [Retrieve Audit Ledger](https://docs.aegisintent.xyz/api-reference/actions/audit-ledger.md): Retrieve the full tax compliance ledger with FIFO cost-basis accounting for all historical trades. - [Get Balances](https://docs.aegisintent.xyz/api-reference/actions/balance.md): Retrieve live stablecoin balances (USDC and EURC) directly from the blockchain relayer. - [Cross-Chain Bridge](https://docs.aegisintent.xyz/api-reference/actions/bridge.md): Perform cross-chain stablecoin bridging via Circle CCTP with gas relay assistance. - [Get Bridging Chains](https://docs.aegisintent.xyz/api-reference/actions/bridge-chains.md): Retrieve all source and destination networks supported by Aegis's CCTP router. - [Estimate Bridge Fee](https://docs.aegisintent.xyz/api-reference/actions/bridge-fee.md): Retrieve estimated relayer gas fees for a proposed cross-chain bridge transfer. - [Check Bridge Status](https://docs.aegisintent.xyz/api-reference/actions/bridge-status.md): Poll the consensus and Circle attestation state of an active cross-chain bridge operation. - [Estimate Transfer Gas](https://docs.aegisintent.xyz/api-reference/actions/estimate-transfer.md): Verify recipient address formatting and retrieve real time gas costs for onchain stablecoin transfer. - [Execute x402 Micropayment](https://docs.aegisintent.xyz/api-reference/actions/pay.md): Autonomously executes a payment to a service endpoint using the agent's USDC wallet on the Arc Network. - [Swap Assets](https://docs.aegisintent.xyz/api-reference/actions/swap.md): Swap between USDC, EURC, and cirBTC directly inside the secure Developer-Controlled Wallet via Circle App Kit. - [Execute Safe Transfer](https://docs.aegisintent.xyz/api-reference/actions/transfer.md): Executes a secure gas-abstracted stablecoin transfer, pre-validated against cumulative limits in the Policy Engine. - [Get Wallet Details](https://docs.aegisintent.xyz/api-reference/actions/wallet.md): Retrieve the cryptographic smart wallet metadata associated with the authenticated profile. - [Register DCA Schedule](https://docs.aegisintent.xyz/api-reference/actions/wealth-dca.md): Register a recurring dollar-cost averaging schedule. The Wealth Sentinel executes each leg automatically at the specified interval. - [Cancel DCA Schedule](https://docs.aegisintent.xyz/api-reference/actions/wealth-dca-cancel.md): Cancel an active DCA schedule by its UUID. - [Get Wealth Intents](https://docs.aegisintent.xyz/api-reference/actions/wealth-intents.md): Retrieve all active limit orders and DCA schedules for the authenticated agent, including their current status (PENDING, EXECUTED, CANCELLED). - [Register Limit Order](https://docs.aegisintent.xyz/api-reference/actions/wealth-limit-order.md): Register a conditional swap order that executes automatically when a target price is reached. The Wealth Sentinel monitors this intent and triggers execution. - [Cancel Limit Order](https://docs.aegisintent.xyz/api-reference/actions/wealth-limit-order-cancel.md): Cancel an active limit order by its UUID. - [Get Wealth Metrics](https://docs.aegisintent.xyz/api-reference/actions/wealth-metrics.md): Retrieve portfolio performance metrics for the authenticated agent, including total deposits, current value, yield earned, and active position breakdown across Aegis Vault and Synthra V3. - [Multi-Yield Deposit](https://docs.aegisintent.xyz/api-reference/actions/wealth-multi-yield.md): Split a USDC deposit across the Aegis aUSDC Vault and Synthra V3 concentrated liquidity in a single atomic action. Weights must add up to 100, and synthraWeight is capped at 80. - [Withdraw from Synthra V3](https://docs.aegisintent.xyz/api-reference/actions/wealth-synthra-withdraw.md): Close the agent's active Synthra V3 concentrated liquidity position and collect all liquidity plus accrued trading fees back to USDC. No request body required. - [Track Agent Position](https://docs.aegisintent.xyz/api-reference/actions/yield-balance.md): Returns the authenticated agent's current position in the vault. Includes the number of shares held, their current USDC value, and importantly, the `lockExpiresAt` timestamp that indicates when MEV cooldowns end. - [Deposit USDC](https://docs.aegisintent.xyz/api-reference/actions/yield-deposit.md): Deposits raw USDC into the yield vault and mints `aUSDC` shares for the agent. The backend automatically handles the ERC-20 approvals required before depositing. **Warning:** This will trigger an MEV cooldown lock preventing immediate withdrawals. - [Get Live Vault State](https://docs.aegisintent.xyz/api-reference/actions/yield-vault.md): Reads directly from the AegisUSDC vault smart contract to return live metrics including Total Value Locked (TVL), estimated APY, and the current Price Per Share. Crucial for understanding appreciation. - [List Yield Vaults](https://docs.aegisintent.xyz/api-reference/actions/yield-vaults.md): Returns a list of all yield-bearing vaults currently supported by Aegis on the Arc Testnet, including their native CA (Contract Address) and descriptive metadata. - [Withdraw USDC](https://docs.aegisintent.xyz/api-reference/actions/yield-withdraw.md): Burns `aUSDC` shares to withdraw the underlying USDC (including any accumulated yield appreciation) back to the agent's wallet. Will return `403` if the MEV cooldown lock is still active. - [Complete Onboarding](https://docs.aegisintent.xyz/api-reference/connect/complete.md): Verify the sent email OTP challenge and return a secure Bearer token linked to the user's database and wallet record. - [Revoke Token](https://docs.aegisintent.xyz/api-reference/connect/revoke.md): Revokes the active Bearer session token immediately. - [Start Onboarding](https://docs.aegisintent.xyz/api-reference/connect/start.md): Initiate session flow for onboarding a new user or agent wallet by sending an email verification code (OTP). - [Marketplace History](https://docs.aegisintent.xyz/api-reference/marketplace/history.md): Retrieve the historic catalog inspection log records for the authenticated agent. - [Inspect Pricing](https://docs.aegisintent.xyz/api-reference/marketplace/inspect.md): Inspect and parse pricing, routing details, and payment parameters for a given Marketplace service URL. - [Search Catalog](https://docs.aegisintent.xyz/api-reference/marketplace/search.md): Query, paginate, and search the Circle Marketplace service resources catalog by keyword, type, or category. - [API Reference](https://docs.aegisintent.xyz/api-reference/overview.md): Complete reference for all Aegis API endpoints - [Get Policy Limits](https://docs.aegisintent.xyz/api-reference/policy/get.md): Retrieve active transaction boundaries and current cumulative limit utilization from the Policy Engine. - [Architecture Overview](https://docs.aegisintent.xyz/architecture/overview.md): How Aegis is structured and how the components fit together - [Authentication](https://docs.aegisintent.xyz/authentication.md): Learn how to authenticate your API requests with Aegis - [CrossChain Bridging](https://docs.aegisintent.xyz/features/bridging.md): Bridge USDC across chains using Circle CCTP - [Risk Monitoring](https://docs.aegisintent.xyz/features/risk-monitoring.md): Liquidation monitoring and risk protection for agent positions - [Swap](https://docs.aegisintent.xyz/features/swap.md): Token swaps via Circle App Kit on the Arc Network - [Tax Loss Harvesting](https://docs.aegisintent.xyz/features/tax-harvesting.md): Automated tax loss harvesting and audit ledger for AI agent portfolios - [Transfers](https://docs.aegisintent.xyz/features/transfers.md): Send USDC to any EVM address on the Arc Network - [Wealth Engine](https://docs.aegisintent.xyz/features/wealth-engine.md): Autonomous portfolio management with limit orders, DCA schedules, multi-yield allocation, and Synthra V3 concentrated liquidity - [x402 Payments](https://docs.aegisintent.xyz/features/x402-payments.md): Enable your agents to autonomously pay for API services using the x402 micropayment protocol - [Yield Vaults](https://docs.aegisintent.xyz/features/yield.md): Generate passive yield for AI agents through autonomous vaults - [Introduction](https://docs.aegisintent.xyz/introduction.md) - [Quickstart](https://docs.aegisintent.xyz/quickstart.md): Connect your first AI agent and execute an autonomous payment in under 5 minutes - [Policy Engine](https://docs.aegisintent.xyz/security/policy-engine.md): How Aegis enforces spending limits and protects your agents from overspending - [Security](https://docs.aegisintent.xyz/security/security.md): Security model and threat mitigation in Aegis ## OpenAPI Specs - [openapi](https://docs.aegisintent.xyz/api-reference/openapi.json)