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 Wealth Engine is fully operational. Agents can register limit orders, schedule DCA strategies, allocate across multiple yield protocols, and withdraw from Synthra V3 positions.

​
Overview

The Aegis Wealth Engine is an autonomous portfolio management layer that gives AI agents access to advanced DeFi strategies beyond basic transfers and swaps. It combines intent-based order execution, dollar-cost averaging, multi-protocol yield allocation, and concentrated liquidity management into a single cohesive API. A background Wealth Sentinel process runs every 5 minutes, scanning all active intents (limit orders and DCA schedules) and automatically executing them when market conditions are met.

​
Limit Orders

Register conditional swap orders that execute automatically when a target price is reached. 
curl -X POST https://api.aegisintent.xyz/v1/actions/wealth/limitOrder \
  -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 '{
    "tokenIn": "USDC",
    "tokenOut": "EURC",
    "amountIn": "100.00",
    "targetPrice": "0.92",
    "condition": "LTE"
  }'

​
Limit Order Parameters

FieldTypeRequiredDescription
tokenInstringYesInput token symbol (e.g. "USDC")
tokenOutstringYesOutput token symbol (e.g. "EURC")
amountInstringYesAmount of the input token to swap
targetPricestringYesThe price threshold that triggers execution
conditionstringYes"LTE" (execute when price ≤ target) or "GTE" (price ≥ target)

​
Cancel a Limit Order

curl -X POST https://api.aegisintent.xyz/v1/actions/wealth/limitOrder/cancel \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -d '{"id": "d290f1ee-6c54-4b01-90e6-d701748f0851"}'

​
Dollar-Cost Averaging (DCA)

Schedule recurring token purchases at fixed intervals. The Wealth Sentinel executes each leg automatically. 
curl -X POST https://api.aegisintent.xyz/v1/actions/wealth/dca \
  -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 '{
    "tokenIn": "USDC",
    "tokenOut": "cirBTC",
    "amountInPerTx": "25.00",
    "frequencyHours": 24
  }'

​
DCA Parameters

FieldTypeRequiredDescription
tokenInstringYesInput token symbol
tokenOutstringYesOutput token symbol
amountInPerTxstringYesAmount to swap per DCA execution
frequencyHoursnumberYesHours between each execution (e.g. 24 = daily)

​
Cancel a DCA Schedule

curl -X POST https://api.aegisintent.xyz/v1/actions/wealth/dca/cancel \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -d '{"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"}'

​
Multi-Yield Allocation

Split a deposit across multiple yield protocols in a single atomic action. Currently supports the Aegis aUSDC Vault and Synthra V3 Concentrated Liquidity. 
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
  }'

​
Multi-Yield Parameters

FieldTypeRequiredDescription
amountUsdcstringYesTotal USDC amount to allocate
aegisWeightnumberYesPercentage allocated to the Aegis aUSDC Vault (0–100)
synthraWeightnumberYesPercentage allocated to Synthra V3 concentrated liquidity (0–100, max 80)
aegisWeight and synthraWeight must add up to 100. To protect agents from excessive external protocol risk, synthraWeight is capped at 80%.

​
Synthra V3 Withdrawal

Manually close a Synthra V3 concentrated liquidity position and collect all accrued fees back to USDC. 
curl -X POST https://api.aegisintent.xyz/v1/actions/wealth/yield/synthra/withdraw \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: b1a2c3d4-e5f6-7890-abcd-1234567890ef" \
  -H "X-Aegis-Nonce: 3"
No request body is required. The system automatically identifies the agent’s active Synthra position and closes it, collecting all liquidity and earned fees.

​
Portfolio Monitoring

​
View Active Intents

Get a list of all active limit orders and DCA schedules for the agent: 
curl -X GET https://api.aegisintent.xyz/v1/actions/wealth/intents \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com"

​
Portfolio Metrics

Get a summary of portfolio performance including total deposited, current value, and yield earned: 
curl -X GET https://api.aegisintent.xyz/v1/actions/wealth/metrics \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com"

​
Wealth Sentinel

The Wealth Sentinel is an autonomous background process that runs every 5 minutes. It:
  1. Scans all PENDING limit orders and checks if market prices meet the trigger condition
  2. Scans all active DCA schedules and checks if enough time has elapsed since the last execution
  3. Automatically executes matching intents using the agent’s Circle Developer Controlled Wallet
  4. Logs all executions to the audit trail for full transparency
The Wealth Sentinel operates fully autonomously — once you register a limit order or DCA schedule, you don’t need to call any additional endpoints. The system handles execution, nonce management, and audit logging automatically.
EndpointMethodDescription
/v1/actions/wealth/limitOrderPOSTRegister a new limit order
/v1/actions/wealth/limitOrder/cancelPOSTCancel an existing limit order
/v1/actions/wealth/dcaPOSTRegister a new DCA schedule
/v1/actions/wealth/dca/cancelPOSTCancel an existing DCA schedule
/v1/actions/wealth/multiYieldPOSTSplit deposit across yield protocols
/v1/actions/wealth/yield/synthra/withdrawPOSTClose Synthra V3 position
/v1/actions/wealth/intentsGETView all active intents
/v1/actions/wealth/metricsGETView portfolio performance metrics