Create hardware subaccount

The subaccount/create endpoint allows hardware wallets to establish master subaccount relationships, allowing traders to trade securely on Pacifica with funds held in a hardware wallet.

Please refer to our Python SDK for a comprehensive guide on hardware subaccount creation.

POST /api/v1/account/subaccount/create

Request Body

Field	Type	Need	Description	Example
"main_account"	string	required	Main account (hardware) wallet address	42trU9A5...
"subaccount"	string	required	Subaccount wallet address	69trU9A5...
"main_signature"	object	required	Contains data of main (hardware) account signature	see below
"type"	string	required	Specifies that this is a Hardware signature	"hardware"
"value"	string	required	Main hardware account signature	"2V4Y7Mpk..."
"timestamp"	integer	required	Current timestamp in milliseconds	1716200000000
"sub_signature"	string	required	Subaccount signature	4k2Wx8Zq...
"expiry_window"	integer	optional	Signature expiry in milliseconds	30000

{
  "main_account": "9AhYvd...",
  "subaccount": "CRTxBM...",
  "main_signature": {
    "type": "hardware",
    "value": "2V4Y7Mpk..."
  },
  "sub_signature": "2VEaHF4...",
  "timestamp": 1749298654181,
  "expiry_window": 200000
}

Response

• Status 200: Subaccount created successfully

{
  "success": true,
  "data": null,
  "error": null,
  "code": null,
}

• Status 400: Bad request

{
  "success": false,
  "data": null,
  "error": "Account not found: CRTxBM...",
  "code": 1
}

• Status 500: Internal server error