Passer au contenu 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.

Creez un nouvel agent avec un portefeuille securise par MPC provisionne automatiquement. L’adresse du portefeuille est generee en utilisant la generation distribuee de cles (DKG) et est prete a recevoir des fonds immediatement.

​
Corps de la requete

​
agent_name
string
requis
Nom d’affichage de l’agent. Doit etre unique au sein de votre compte.
​
agent_description
string
Description optionnelle de l’objectif de l’agent.
​
chain
string
requis
Identifiant de chaine CAIP-2 pour le portefeuille de l’agent. Consultez Chaines supportees pour les options disponibles.Exemples : eip155:1 (Ethereum), eip155:8453 (Base), eip155:84532 (Base Sepolia testnet)
​
metadata
string
Chaine de metadonnees encodee en JSON pour les paires cle-valeur personnalisees.

​
Reponse

​
Exemple

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"
}

Autorisations

​
X-API-Key
string
header
requis

API key authentication. Keys are prefixed with awx_.

Corps

application/json
​
agent_name
string
requis

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

​
chain
string
requis

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.

Réponse

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.

Options disponibles:
active,
inactive
​
metadata
string

JSON-encoded metadata string.

​
created_at
string<date-time>

ISO 8601 creation timestamp.