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.

POST /api/v1/account/subaccount/create

Request Body

Field	Type	Need	Description	Example
"main_account"	string	required	Main account wallet address	42trU9A5...
"subaccount"	string	optional	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...",
  "timestamp": 1716200000000,
  "main_signature": "5j1Vy9Uq...",
  "sub_signature": "4k2Wx8Zq...",
  "expiry_window": 30000
}

Response

• Status 200: Subaccount created successfully

 {
    "success": true
  }

• Status 400: Bad request

  {
    "error": "Failed to create subaccount",
    "code": 400
  }

• Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "main_account": "42trU9A5...",
    "subaccount": "69trU9A5...",
    "timestamp": 1716200000000,
    "main_signature": "5j1Vy9Uq...",
    "sub_signature": "4k2Wx8Zq..."
}

response = requests.post(
    "/api/v1/account/subaccount/create",
    json=payload,
    headers={"Content-Type": "application/json"}
)

data = response.json()