Create subaccount
This endpoint allows regular accounts to create subaccounts with a secure authentication scheme. Both the main account and subaccount must sign to establish the relationship.
The subaccount creation process follows the below steps.
The main account must authorize the creation of a subaccount under its control
The subaccount must consent to being controlled by the main account
The API server must verify both signatures to prevent unauthorized subaccount creation
Please refer to the Python SDK for a comprehensive guide on subaccount creation via API
POST /api/v1/account/subaccount/create
Request Body
"main_account"
string
required
Main account wallet address
42trU9A5...
"subaccount"
string
required
Subaccount wallet address
69trU9A5...
"timestamp"
integer
required
Current timestamp in milliseconds
1716200000000
"main_signature"
string
required
Main account signature
5j1Vy9Uq...
"sub_signature"
string
required
Subaccount signature
4k2Wx8Zq...
"expiry_window"
integer
optional
Signature expiry in milliseconds
30000
{
"main_account": "42trU9A5...",
"subaccount": "69trU9A5...",
"main_signature": "5j1Vy9Uq...",
"sub_signature": "4k2Wx8Zq...",
"timestamp": 1716200000000,
"expiry_window": 30000
}
Response
Status 200: Subaccount created successfully
{
"success": true,
"data": null,
"error": null,
"code": null,
}
Status 400: Bad request
{
"success": false,
"data": null,
"error": "Account already exists: CRTxBM...",
"code": 2
}
Status 500: Internal server error
Last updated