Create an Agent

Create and configure an agent via the web UI or REST API.

Web UI

Navigate to /agents, click Create Agent, set a name, select chains and capabilities, and configure the spending cap. Save the access token when prompted — it cannot be recovered without reissue.

REST API

POST/api/agents

Create a new agent with multi-chain wallets and return a one-time access token.

curl -X POST http://127.0.0.1:8000/api/agents \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Trading Assistant",
    "description": "Multi-chain gas analyst",
    "chains": ["ethereum", "arbitrum", "base"],
    "capabilities": ["read", "compare", "analytics"],
    "spending_cap": 0.05
  }'

Response includes id, access_token, and wallet_addresses per protocol family.

Update configuration

Use PUT /api/agents/{id} with the access token header to change chains, capabilities, or spending cap. Wallet keys are not rotated on update.