新建子账户API Key

描述

• 该接口用于新建统一账户子账户的API Key，即母账户为混合帐户模式或统一账户模式。如当前母账户模式为经典账户，则无法调用该接口；
• 目前只支持虚拟子账户的创建

HTTP请求

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

请求示例

curl -X POST "https://api.bitget.com/api/v3/user/create-sub-api" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \
   -d '{"subUid":"xxx","note":"xxx","type":"read_only","permissions":["uta_trade"],"passphrase":"1234567Aa","ips":["127.0.0.1"]}'

请求参数

参数名	参数类型	是否必须	描述
subUid	String	是	子账户ID
note	String	是	备注名称 长度限制20字符；需以字母开头，支持[0-9], [a-z], [A-Z]以及[-,_]
type	String	是	权限类型 read_write 读写 read_only 只读
passphrase	String	是	密钥 长度为8至32位的英文字母与数字组合
permissions	Array	是	权限值 统一账户权限: uta_mgt 统一账户管理 uta_trade 统一账户交易
ips	Array	是	提币白名单IP 支持传入多个IP地址 单密钥最多支持绑定30个IP 只支持IPv4

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740213448866,
  "data": {
    "note": "test",
    "apiKey": "***********************************",
    "secret": "*********************************************",
    "type": "read_only",
    "permissions": [
      "uta_trade"
    ],
    "ips": [
      "127.0.0.1"
    ]
  }
}

返回参数

返回字段	参数类型	字段说明
note	String	备注
apikey	String	子账户api key
secret	String	子账户密钥
type	String	子账户API Key权限类型 read_write 读写 read_only 只读
permissions	Array	子账户API Key权限值 统一账户权限: uta_mgt 统一账户管理 uta_trade 统一账户交易
ips	Array	子账户提币IP白名单列表