修改子账户API Key

描述

该接口用于修改统一账户子账户API Key权限及提币白名单IP地址。仅支持修改统一账户子账户的API Key，不支持创建经典账户子账户的API Key

HTTP请求

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

请求示例

curl -X POST "https://api.bitget.com/api/v3/user/update-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 '{"apiKey":"***********************************","type":"read_write","passphrase":"88888888","permissions":["uta_trade"]}'

请求参数

参数名	参数类型	是否必须	描述
apikey	String	是	子账户API Key
passphrase	String	是	密钥 长度为8至32位的英文字母与数字组合
type	String	否	权限类型 read_write 读写 read_only 只读 permissions有值时此参数必传
permissions	Array	是	权限值 统一账户权限: uta_mgt 统一账户管理 uta_trade 统一账户交易 type有值时此参数必传
ips	Array	否	提币白名单IP 如不传，则不修改IP地址 如传空值，则删除提币白名单 支持传入多个IP地址 单密钥最多支持绑定30个IP 只支持IPv4

返回示例

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

返回参数

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