Saltar al contenido principal
POST
/
api
/
v1
/
agents
Create Agent
curl --request POST \
  --url https://api.agentwallex.com/api/v1/agents \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_name": "research-bot",
  "agent_description": "Market research automation agent",
  "chain": "eip155:84532",
  "metadata": "{\"team\":\"growth\"}"
}
'
{
  "id": "agent_abc123",
  "agent_name": "research-bot",
  "agent_description": "Market research automation agent",
  "wallet": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "chain": "eip155:84532"
  },
  "status": "active",
  "created_at": "2025-06-01T10:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt

Use this file to discover all available pages before exploring further.

Cree un nuevo agente con una billetera con seguridad MPC aprovisionada automáticamente. La dirección de la billetera se genera utilizando Generación de Claves Distribuida (DKG) y está lista para recibir fondos inmediatamente.

​
Cuerpo de la solicitud

​
agent_name
string
requerido
Nombre visible del agente. Debe ser único dentro de su cuenta.
​
agent_description
string
Descripción opcional del propósito del agente.
​
chain
string
requerido
Identificador de cadena CAIP-2 para la billetera del agente. Consulte Cadenas compatibles para las opciones disponibles.Ejemplos: eip155:1 (Ethereum), eip155:8453 (Base), eip155:84532 (Base Sepolia testnet)
​
metadata
string
Cadena de metadatos codificada en JSON para pares clave-valor personalizados.

​
Respuesta

​
Ejemplo

curl -X POST https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "research-bot",
    "agent_description": "Market research automation agent",
    "chain": "eip155:84532",
    "metadata": "{\"team\":\"growth\"}"
  }'
Response
{
  "id": "agent_abc123",
  "agent_name": "research-bot",
  "agent_description": "Market research automation agent",
  "wallet": {
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "chain": "eip155:84532"
  },
  "status": "active",
  "created_at": "2025-06-01T10:00:00Z"
}

Autorizaciones

​
X-API-Key
string
header
requerido

API key authentication. Keys are prefixed with awx_.

Cuerpo

application/json
​
agent_name
string
requerido

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

​
chain
string
requerido

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.

Respuesta

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.

Opciones disponibles:
active,
inactive
​
metadata
string

JSON-encoded metadata string.

​
created_at
string<date-time>

ISO 8601 creation timestamp.