Skip to main content

Modify Virtual Subaccount Apikey

Frequency limit: 5 times/1s (User ID)

Description

Only supports API Key calls from the main account, and the API Key needs to be bound to an IP address

Modify the virtual sub-account or general sub-account API Key

HTTP Request

  • POST /api/v2/user/modify-virtual-subaccount-apikey
Request Example
curl -X POST "https://api.bitget.com/api/v2/user/modify-virtual-subaccount-apikey" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \
-d '{"subAccountUid":"1","subAccountApiKey":"xx_xxx", "passphrase":"xxx","permList":["spot_trade","contract_trade"],"label":"label","ipList":["127.0.0.1","127.0.0.2"]}'

Request Parameters

ParameterTypeRequiredDescription
subAccountUidStringYesSub-account uid
passphraseStringYesPasscode English letters of 832 characters + numbers
labelStringYesNote Length 20
ipListList<String>Noip whitelist
Up to 30, if not then ip whitelist is set to empty.
permListList<String>NoSub-account permissions
spot_trade: Spot trade
margin_trade: Spot Marign trade
contract_trade: Futures trade read-write
transfer:Wallet transfer
read: Read permissions
If this parameter is not passed, it will be ignored, and the existing permissions will be retained
If an empty value is passed, the existing permissions of this API Key will be removed
subAccountApiKeyYesStringSub-account ApiKey
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1682660169412,
"data": {
"subAccountUid": "1",
"label": "sub api",
"subAccountApiKey": "xx_xxx",
"secretKey": "xxx",
"permList": [
"spot_trade",
"contract_trade"
],
"ipList": [
"127.0.0.1"
]
}
}

Response Parameters

ParameterTypeDescription
subAccountUidStringSub-account uid
subAccountApiKeyStringSub-account apikey
secretKeyStringsecretKey
permListListSub-account permissions
spot_trade: Spot trade
margin_trade: Spot Marign trade
contract_trade: Futures trade read-write
transfer:Wallet transfer
read: Read permissions
labelStringSub-account apikey note
ipListListSub-account apikey ip whitelist

How was your Reading Experience with us?