On this page

# 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

Previous Subaccounts
Next Subaccount fund transfer

Last updated 3 months ago