Create Account

API Documentation: Create Account

Overview

This API endpoint allows you to create account. On the background, it will start a key generation process for ECDSA & EDDSA keypair.

• HTTP Method: POST
• Endpoint: /api/v1/wallet/account

Request Body Parameters

• subId (required): this will be used to identify the keypair.
• network (optional): When network is not defined, it will create all wallet for all supported networks. You can see Networks Reference to get the network code.
• chainId : chainId is mandatory when the network is EVM.
• pin (optional) : When pin is set, the wallets that created from this request will assigned to this pin.
• recoveryPin (optional) : Recovery PIN only mandatory when PIN is set. When Recovery PIN is set, the wallets that created from this request will assigned to this Recovery PIN.

Example Request Body

// Generate wallet for all supported network
{      
    "subId": "..."
}

// Specific network
{      
    "subId": "...",
    "network": "EVM",
    "chainId": 1
}
 
{      
    "subId": "...",
    "network": "BITCOIN"    
}
 
{      
    "subId": "...",
    "network": "SOLANA"    
}
 
{      
    "subId": "...",
    "network": "TRON"    
}

Request

Request Headers

• X-CLIENT-ID: (required): Client ID which was generated when register in Xellar TSS API Service Dashboard.
• X-SIGNATURE: (required): Calculated signature, please refer to Authorization section.
• X-TIMESTAMP: (required): Request timestamp in RFC3339 format.

Example Request Syntax

curl -X POST -H "Content-Type: application/json" -H "x-client-id: $YOUR_CLIENT_ID" -H "x-client-secret: $YOUR_CLIENT_SECRET" -d '{
    "subId": "...",
    "network": "EVM",
    "chainId": 1
}' <BASE_URL>/api/v1/wallet/account

Response

The response will include a JSON object with the following properties:

• status (number): The HTTP status code of the response (e.g., 200 for success).
• message (string): A message providing additional information about the operation.
• data (object): An object containing the request information.
• data.requestId (string): The unique identifier for the request.

Example Response

{
    "status": 200,
    "message": "Account creation is in progress",
    "data": {
        "requestId": "9c276eb2-e0e1-4789-bd54-42d5e920379f"        
    }
}