Create Agent Subaccount

Frequency limit: 1 times/1s (UID)

Description

Create a dedicated sub-account for an AI Agent instance. Agent sub-accounts are not editable after creation (name, permissions, and other configurations cannot be modified). Each main account shares the total sub-account quota with regular sub-accounts.

HTTP Request

• POST /api/v2/user/create-agent-subaccount

Request

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

Request Parameters

Parameter	Type	Required	Description
username	String	Yes	Username used to generate the virtual email address. Only lowercase letters are allowed; maximum 20 characters
passphrase	String	Yes	API key passphrase. Must be 8–32 characters, consisting of letters and numbers
note	String	No	Sub-account note

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "username": "xxxx@virtual-bitget.com",
    "subUid": "xxxx",
    "apiKey": "***********************************",
    "secret": "*********************************************",
    "note": "xxxx",
    "createdTime": "1740211445041"
  }
}

Response Parameter

Parameter	Type	Description
username	String	Agent sub-account username
subUid	String	Agent sub-account ID
apiKey	String	Agent sub-account API key
secret	String	Agent sub-account secret
note	String	Note
createdTime	String	Creation time, Unix millisecond timestamp