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.

  1. The main account must authorize the creation of a subaccount under its control

  2. The subaccount must consent to being controlled by the main account

  3. 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

Field
Type
Need
Description
Example

"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