Skip to main content
POST
Create Agent
Multi-step Process: This endpoint creates a new agent, generates a blockchain wallet, and can fund the wallet from your user account or via a testnet faucet.

Request Headers

string
required
Your API key for authentication

Request Body

string
required
ID of the user creating the agent
string
User’s wallet address for funding (optional)
string
required
Name of the agent
string
Purpose and functionality of the agent
integer
Initial balance to fund the agent (in smallest units)
integer
Maximum amount that can be spent per day
integer
Maximum amount for a single transaction
string
default:"USDC"
Currency type to use (defaults to USDC)
boolean
default:"false"
Whether all transactions require approval
integer
Transactions above this amount require approval
array
Categories or labels to assign to the agent

Response

string
Unique agent identifier
string
The API key for the agent
string
Name of the agent
string
Purpose and functionality of the agent
string
Current status of the agent (active, inactive, paused)
object
string
Current balance of the agent
string
Currency type used
object
array
Categories or labels assigned to the agent
string
Timestamp when the agent was created
object
object

Status Codes

Important: Store the returned API key securely as it will be needed for all future operations with this agent.