Agents API

Create, configure, fund, and authenticate agents.

POST/api/agents

Create agent. Returns id, access_token (once), wallet_addresses.

{
  "name": "string",
  "description": "string | null",
  "chains": ["ethereum", "base"],
  "capabilities": ["read", "compare", "transact", "analytics"],
  "spending_cap": 0.1
}

GET/api/agents

List all agents (summary fields only).

GET/api/agents/{id}X-Agent-Access-Token

Full agent detail excluding encrypted key material.

PUT/api/agents/{id}X-Agent-Access-Token

Update name, chains, capabilities, or spending_cap.

DELETE/api/agents/{id}X-Agent-Access-Token

Soft-delete — sets is_active=false (204 No Content).

GET/api/agents/{id}/balancesX-Agent-Access-Token

Multi-chain native balances for the agent wallets.

POST/api/agents/{id}/fundX-Agent-Access-Token

Funding instructions and deposit addresses.

GET/api/agents/{id}/reissue-challenge

Canonical message for wallet-signature token reissue.

POST/api/agents/{id}/reissue-token

Reissue access token with current_token or wallet_signature proof.