Skip to main content

🔌 API Reference

The Agent Wallet Service exposes a comprehensive REST API for nearly all core functions.

🔐 Authentication​

All requests (except health/onboarding) require the X-API-Key header.

curl -H "X-API-Key: your_key_here" http://localhost:3000/wallet/list

📂 Route Groups​

1. Wallets (/wallet)​

  • GET /list: List all wallets.
  • POST /create: Generate a new non-custodial wallet.
  • POST /import: Import an existing private key.
  • GET /:address/balance: Get native/token balance.
  • POST /:address/send: Route a transaction through the policy engine.

2. Identity (/identity)​

  • POST /create: Provision an ERC-8004 identity.
  • GET /list: List all agent identities.
  • GET /:agentId: Get metadata and capabilities.

3. ENS (/ens)​

  • GET /check/:name: Check name availability.
  • POST /register: Register a new .eth name (if eligible).

4. Policy (/policy)​

  • GET /rules: List current enforcement rules.
  • POST /update: Change limits or whitelists.

5. Webhooks (/webhooks)​

  • POST /subscribe: Listen for transaction confirmations or HITL requests.
  • GET /history: List delivery logs.

📡 WebSockets​

Real-time events are broadcasted to connected clients.

  • tx.confirmed: Sent when a transaction hit the block.
  • policy.hitl: Sent when a transaction is paused for approval.
  • agent.activity: General activity log heartbeats.