Skip to main content
POST
Create Agent
Create a new agent with an automatically provisioned MPC-secured wallet. The wallet address is generated using Distributed Key Generation (DKG) and is ready to receive funds immediately.

Request Body

string
required
Display name for the agent. Must be unique within your account.
string
Optional description of the agent’s purpose.
string
required
CAIP-2 chain identifier for the agent’s wallet. See Supported Chains for available options.Examples: eip155:1 (Ethereum), eip155:8453 (Base), eip155:84532 (Base Sepolia testnet)
string
JSON-encoded metadata string for custom key-value pairs.

Response

Example

Response

Authorizations

X-API-Key
string
header
required

API key authentication. Keys are prefixed with awx_.

Body

application/json
agent_name
string
required

Display name for the agent. Must be unique within your account.

chain
string
required

CAIP-2 chain identifier for the agent's wallet (e.g., eip155:1 for Ethereum, eip155:8453 for Base, eip155:84532 for Base Sepolia testnet).

agent_description
string

Optional description of the agent's purpose.

metadata
string

JSON-encoded metadata string for custom key-value pairs.

Response

Agent created successfully.

An AI agent with an MPC-secured wallet.

id
string

Unique agent identifier (e.g., agent_abc123).

agent_name
string

Agent display name.

agent_description
string

Agent description.

wallet
object

An on-chain wallet associated with an agent.

status
enum<string>

Agent status.

Available options:
active,
inactive
metadata
string

JSON-encoded metadata string.

created_at
string<date-time>

ISO 8601 creation timestamp.