Quickstart

Get Started with Aegis

This guide walks through the core Aegis lifecycle:

Give your agent the live Aegis skill instructions.
Connect the agent and receive an API token.
Verify the provisioned Arc wallet.
Execute a guarded x402 payment.

Prerequisites

Before you begin, make sure you have:

An email address for the agent
curl or another HTTP client
Access to https://api.aegisintent.xyz
A way to store the returned token securely

Step 1: Load the Agent Skill File

Aegis publishes a live SKILL.md file that teaches an AI agent the required headers, nonce flow, idempotency rules, supported actions, and recovery patterns.

curl https://api.aegisintent.xyz/SKILL.md

Use this prompt when bootstrapping the agent:

get started on aegis: https://api.aegisintent.xyz/SKILL.md

For autonomous agents, load SKILL.md before allowing the agent to request transfers, payments, swaps, bridges, or yield actions.

Step 2: Connect the Agent

Aegis uses an email OTP flow to bind an agent identity to a token and wallet.

Request a verification code

curl -X POST https://api.aegisintent.xyz/v1/connect/start \
  -H "Content-Type: application/json" \
  -d '{"email": "your-agent@example.com"}'

Example response:

{
  "success": true,
  "challengeId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "expiresAt": "2026-05-20T00:45:00.000Z",
  "message": "Verification code prepared. Complete the challenge before a token is issued."
}

Complete the OTP challenge

Submit the challengeId and the 6-character code sent to the agent email.

curl -X POST https://api.aegisintent.xyz/v1/connect/complete \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-agent@example.com",
    "challengeId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "otp": "A8F93D"
  }'

On success, Aegis registers the agent, provisions a Circle Developer Controlled Wallet on Arc, and returns a bearer token.

{
  "success": true,
  "agent": {
    "id": "clx1abc2d0001...",
    "email": "your-agent@example.com",
    "walletId": "85d48e9b-bd7c-5181-a980-89ae1233272e",
    "walletAddress": "0xc27508085e5b2128e5a14dedacb53d6525dbcbde"
  },
  "tokenIssued": true,
  "token": "aegis_live_wzm79d9Jzd7LMY4T2iOoWICg1puoWkL...",
  "tokenExpiresAt": "2026-06-19T00:35:00.000Z"
}

Store the token immediately. The plaintext token is shown once and is stored as a hash by Aegis.

Step 3: Check the Wallet

Use the token and registered email on every authenticated request.

curl -X GET https://api.aegisintent.xyz/v1/actions/balance \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: your-agent@example.com"

Example response:

{
  "success": true,
  "wallet": {
    "walletId": "85d48e9b-bd7c-5181-a980-...",
    "walletAddress": "0xc27508085e5b2128e5a14..."
  },
  "balance": [
    {
      "token": {
        "blockchain": "ARC-TESTNET",
        "name": "USDC",
        "symbol": "USDC",
        "decimals": 18,
        "isNative": true
      },
      "amount": "39.492258598461631676",
      "blockchain": "ARC-TESTNET"
    }
  ]
}

Step 4: Execute an x402 Payment

Search for paid services first:

curl -X POST https://api.aegisintent.xyz/v1/marketplace/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: your-agent@example.com" \
  -d '{"keyword": "crypto"}'

Then route the payment through Aegis. Financial actions require both an Idempotency-Key and X-Aegis-Nonce.

curl -X POST https://api.aegisintent.xyz/v1/actions/pay \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: your-agent@example.com" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "X-Aegis-Nonce: 0" \
  -d '{
    "serviceUrl": "https://api.example.com/v1/data",
    "maxAmount": "1.50",
    "method": "GET"
  }'

Example response:

{
  "success": true,
  "result": {
    "status": "completed",
    "paymentProtocol": "x402",
    "chargedUsdc": "1.00",
    "response": {
      "status": 200,
      "data": { "message": "service response" }
    }
  }
}

Start Here

How Aegis Works

Agent Actions

Operations

Get Started with Aegis

Prerequisites

Step 1: Load the Agent Skill File

Step 2: Connect the Agent

Step 3: Check the Wallet

Step 4: Execute an x402 Payment

Next Steps

Authentication

Transfers

Wealth Engine

API Reference

​Get Started with Aegis

​Prerequisites

​Step 1: Load the Agent Skill File

​Step 2: Connect the Agent

​Step 3: Check the Wallet

​Step 4: Execute an x402 Payment

​Next Steps

Authentication

Transfers

Wealth Engine

API Reference

Get Started with Aegis

Prerequisites

Step 1: Load the Agent Skill File

Step 2: Connect the Agent

Step 3: Check the Wallet

Step 4: Execute an x402 Payment

Next Steps