Skip to main content

👛 Wallets API

Manage non-custodial and custodial wallets for AI agents.

Endpoints​

POST /wallet/create​

Create a new wallet with an encrypted private key.

  • Body: { "agentName": "string", "chain": "string" }
  • Returns: Wallet metadata (address, ID, chain).

POST /wallet/import​

Import an existing private key.

  • Body: { "privateKey": "string", "agentName": "string", "chain": "string" }

GET /wallet/list​

List all wallets managed by your API key.

GET /wallet/:address/balance​

Fetch native and token balances.

  • Query: ?chain=base-sepolia
  • Returns: { "eth": "1.23", "tokens": [...] }

POST /wallet/:address/send​

Route a transaction through the Policy Engine.

  • Body: { "to": "address", "value": "0.1", "chain": "string" }
  • Returns: Transaction hash or policy_blocked error.