创建 Agent 子账户

描述

为 AI Agent 实例创建专属子账户。Agent 子账户创建后不支持编辑（名称、权限等配置均不可修改）。每个主账户可创建的 Agent 子账户数量上限与普通子账户共享总配额。

HTTP请求

• POST /api/v3/user/sub-account/agent-create
• 限频规则: 1次/秒/UID
• 需要统一账户管理读写权限
• 仅母账户才能调用此接口

请求示例

curl -X POST "https://api.bitget.com/api/v3/user/sub-account/agent-create" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{"username": "xxxx", "passphrase": "xxxx", "note": "xxxx"}'

请求参数

参数名	参数类型	是否必须	描述
username	String	是	用于生成虚拟邮箱地址的用户名。只能是小写字母且不能超过20个字符
passphrase	String	是	API Key 密钥，长度为8至32位的英文字母与数字组合
note	String	否	子账户备注

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "username": "[email protected]",
    "subUid": "xxxx",
    "apiKey": "***********************************",
    "secret": "*********************************************",
    "note": "xxxx",
    "createdTime": "1740211445041"
  }
}

返回参数

返回字段	参数类型	字段说明
username	String	Agent 子账户昵称
subUid	String	Agent 子账户 ID
apiKey	String	Agent 子账户 API Key
secret	String	Agent 子账户密钥
note	String	备注
createdTime	String	创建时间，Unix毫秒时间戳