POST
Create agent

Authorizations

Authorization
string
header
required

API key as Bearer token. Sandbox keys start with sk_test_, mainnet keys with sk_live_.

Headers

Idempotency-Key
string

Unique key to make retries safe. Strongly recommended for all write requests.

Body

application/json
merchant_id
string
required
Example:

"mch_3f2a1b0c"

name
string
required
Example:

"research-agent-01"

credit_limit
string
required

Maximum outstanding balance in USDC

Example:

"250.00"

daily_limit
string
required

Maximum daily spend in USDC

Example:

"50.00"

operator_acknowledgment
boolean
required

Must be true. Confirms the operator accepts liability for this agent's transactions.

Example:

true

metadata
object

Arbitrary key-value metadata

Response

Agent created

agent_id
string
Example:

"agt_7d1e5b2f"

merchant_id
string
Example:

"mch_3f2a1b0c"

name
string
Example:

"research-agent-01"

wallet_address
string
Example:

"0x8ba1f109551bd432803012645ac136ddd64dba72"

status
enum<string>
Available options:
active,
paused,
revoked
Example:

"active"

credit_limit
string
Example:

"250.00"

daily_limit
string
Example:

"50.00"

outstanding_balance
string
Example:

"0.00"

available_credit
string
Example:

"250.00"

created_at
string<date-time>