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.

​
API Reference

The Aegis API provides a REST interface for AI agents to manage wallets, execute USDC transactions, discover paid services via the x402 protocol, and interact with DeFi on the Arc Network.

​
Base URL

https://api.aegisintent.xyz
All endpoints are relative to this base URL.

​
Authentication

All authenticated endpoints require two headers: 
Authorization: Bearer aegis_live_wzm79d9Jzd7LMY4...
X-Aegis-Email: your-agent@example.com
Obtain a token through the Connect API. Tokens expire after 30 days. Both headers must match the same agent record or the request is rejected.

​
Request Format

Send all request bodies as JSON. Include the following header: 
Content-Type: application/json

​
Response Format

All responses follow a consistent envelope structure: 
{
  "success": true,
  "result": { ... }
}
FieldTypeDescription
successbooleantrue on success, false on error
resultobjectResponse payload (on success)
errorstringHuman-readable error message (on failure)
codestringMachine-readable error code (on failure)
Error response: 
{
  "success": false,
  "error": "Unauthorized: Invalid token",
  "code": "UNAUTHORIZED"
}

​
Rate Limits

ScopeLimitWindow
Connect API10 requestsper 10 minutes per IP
Actions API120 requestsper minute per agent
Marketplace API90 requestsper minute per agent
Policy API60 requestsper minute per agent
Exceeding a limit returns 429 Too Many Requests.

​
Idempotency

For financial operations (transfer, pay, bridge, swap), include an Idempotency-Key header to prevent duplicate transactions: 
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000
If you repeat a request with the same key, the API returns the original response instead of executing the operation again. Keys must be valid UUID v4 values.

​
Financial Action Headers

Financial mutations require two additional headers beyond standard authentication:
HeaderTypeDescription
Idempotency-KeyUUID v4Prevents duplicate execution on retries
X-Aegis-NonceintegerAgent’s current action nonce (increments per action)

​
Endpoint Groups

​
Connect API

Agent onboarding, token issuance, and token revocation.
MethodEndpointDescription
POST/v1/connect/startRequest an email verification OTP
POST/v1/connect/completeSubmit OTP to receive API token + wallet
POST/v1/connect/revokeRevoke all active tokens

​
Actions API

Wallet operations, USDC transfers, x402 payments, bridging, swaps, yield, wealth management, and audit.
MethodEndpointDescription
GET/v1/actions/walletGet agent wallet ID and address
GET/v1/actions/balanceGet wallet balances across all chains
GET/v1/actions/nonceGet current action nonce
GET/v1/actions/policyGet agent spending policy limits
POST/v1/actions/transferSend USDC to an EVM address
POST/v1/actions/payExecute an x402 micropayment
POST/v1/actions/bridgeBridge USDC cross-chain via CCTP
POST/v1/actions/bridge/feeGet bridge fee estimate
POST/v1/actions/bridge/statusCheck bridge transaction status
GET/v1/actions/bridge/chainsList supported bridge chains
POST/v1/actions/swapExecute a token swap
POST/v1/actions/swap/estimateGet swap quote
GET/v1/actions/swap/historyGet swap transaction history
POST/v1/actions/estimate/transferEstimate transfer gas cost
POST/v1/actions/estimate/payEstimate x402 payment cost
POST/v1/actions/estimate/bridgeEstimate bridge cost
GET/v1/actions/yield/vaultsList available yield vaults
GET/v1/actions/yield/vaultGet live vault state and APY
GET/v1/actions/yield/balanceGet agent yield balance (aUSDC shares)
POST/v1/actions/yield/depositDeposit USDC into yield vault
POST/v1/actions/yield/withdrawWithdraw aUSDC shares for USDC + yield
POST/v1/actions/wealth/limitOrderRegister a conditional limit order
POST/v1/actions/wealth/limitOrder/cancelCancel an active limit order
POST/v1/actions/wealth/dcaRegister a DCA schedule
POST/v1/actions/wealth/dca/cancelCancel an active DCA schedule
POST/v1/actions/wealth/multiYieldSplit deposit across Aegis Vault + Synthra V3
POST/v1/actions/wealth/yield/synthra/withdrawClose Synthra V3 position
GET/v1/actions/wealth/intentsView all active wealth intents
GET/v1/actions/wealth/metricsView portfolio performance metrics
GET/v1/actions/audit/ledgerGenerate tax compliance ledger
POST/v1/actions/audit/harvestRun tax loss harvesting

​
Marketplace API (x402)

Discover, inspect, and track paid API services.
MethodEndpointDescription
POST/v1/marketplace/searchSearch for x402 services by keyword or category
POST/v1/marketplace/inspectInspect a service’s payment requirements
GET/v1/marketplace/historyView marketplace interaction history

​
Policy API

View agent spending limits.
MethodEndpointDescription
GET/v1/policyGet current spending policy limits
For detailed feature guides, see: Yield, Wealth Engine, and Tax Harvesting.