Swap

Token Swaps

Agents perform onchain token swaps on the Arc Network via Circle App Kit. Swap between supported assets (USDC, EURC, cirBTC) directly through the API.

How It Works

Get a quote: Call /v1/actions/swap/estimate to see expected output and fees
Execute: Call /v1/actions/swap with an idempotency key and nonce
Track: Call /v1/actions/swap/history to review past swaps

Get a Swap Quote

curl -X POST https://api.aegisintent.xyz/v1/actions/swap/estimate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "tokenIn": "USDC",
    "tokenOut": "EURC",
    "amount": "10.00"
  }'

Execute a Swap

curl -X POST https://api.aegisintent.xyz/v1/actions/swap \
  -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",
    "amount": "10.00",
    "slippageBps": 50
  }'

Parameters

Field	Type	Required	Description
`tokenIn`	string	Yes	Input token symbol or contract address
`tokenOut`	string	Yes	Output token symbol or contract address
`amount`	string	Yes	Amount of the input token to swap
`slippageBps`	number	No	Slippage tolerance in basis points (e.g. 50 = 0.5%)

Swap History

curl -X GET "https://api.aegisintent.xyz/v1/actions/swap/history?limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com"

Start Here

How Aegis Works

Agent Actions

Operations

Token Swaps

How It Works

Get a Swap Quote

Execute a Swap

Parameters

Swap History

​Token Swaps

​How It Works

​Get a Swap Quote

​Execute a Swap

​Parameters

​Swap History

Token Swaps

How It Works

Get a Swap Quote

Execute a Swap

Parameters

Swap History