Create Wallet

The Create Wallet endpoint allows you to create a new wallet within your Signchain Vault. Each wallet is identified by a unique address and can be configured with a name to help organize and reference different wallets.

Endpoint

POST/api/v1/vaults/:vaultId/wallets

Test Endpoint

Request Headers

Authorization: Bearer token for authentication. Should be Bearer <Your-API-Key>.
Content-Type: Must be application/json.
Accept: Must be application/json.

Request Parameters

vaultId - The unique identifier of the vault where the wallet will be created.

Request Body

The request body should be in JSON format and includes the following:

name (string) - A custom name to assign to the wallet for easy reference.

Example Request

curl -X POST https://signchain.net/api/v1/vaults/{vaultId}/wallets \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <API_KEY>" \
     -d '{
           "name": "My New Wallet"
         }'

Example Response

{
  "success": Request_Success_Status,
  "data": {
    "id": "<Your-Wallet-ID>",
    "account": "<Your-Account-ID>",
    "vault": "<Your-Vault-ID>",
    "name": "My New Wallet",
    "address": "<Your-Unique-Wallet-Address>",
    "created": "<Current-Date-ISO>",
    "updated": "<Current-Date-ISO>"
  },
  "error": "<Request-Error-Message>"
}

Response Fields

The response contains the newly created wallet object with the following fields:

success: A boolean true or false determining whether the create request was successful or not. If the create request was not successful, this value will be false and the error field will be populated.
error: A string error message, only sent if the success parameter is false.
id (string) - The unique identifier of the wallet within the vault.
account (string) - Your Signchain account ID.
vault (string) - Your vault's unique identifier.
name (string) - The descriptive name assigned to the wallet.
address (string) - The unique Ethereum address of the wallet.
created (string, ISO 8601 format) - The date and time when the wallet was created.
updated (string, ISO 8601 format) - The last updated date of the wallet, which will be when it was created.

Using this endpoint, you can set up new wallets in your vault, assigning unique names to keep your accounts organized. Each wallet is ready for transactions immediately upon creation.

Signchain Docs