Skip to main content
POST
/
v1
/
createWallet
CreateWallet
curl --request POST \
  --url https://api.mpcvault.com/v1/createWallet \
  --header 'Content-Type: application/json' \
  --header 'x-mtoken: <api-key>' \
  --data '
{
  "vaultUuid": "<string>",
  "callbackClientSignerPublicKey": "<string>",
  "networkType": "NETWORK_TYPE_UNKNOWN",
  "ref": "<string>",
  "name": "<string>"
}
'
{
  "details": {
    "vaultUuid": "<string>",
    "keyType": "KEY_TYPE_UNSPECIFIED",
    "keyPath": "<string>",
    "publicKey": "aSDinaTvuI8gbWludGxpZnk=",
    "networkType": "NETWORK_TYPE_UNKNOWN",
    "address": "<string>",
    "ref": "<string>",
    "status": "STATUS_UNSPECIFIED",
    "name": "<string>"
  },
  "error": {
    "executeSigningRequestsErrorCode": "EXECUTE_SIGNING_REQUESTS_ERROR_CODE_UNSPECIFIED",
    "message": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mpcvault.com/llms.txt

Use this file to discover all available pages before exploring further.

Creates a new wallet in the specified vault. Use the returned address in the response (do not derive it yourself). Run your own sanity checks before using the wallet in production.

Authorizations

​
x-mtoken
string
header
required

Your API token. Required for all API requests.

Body

application/json
​
vaultUuid
string

required:true symbol_value:"12789f5ee5fb-07f5-470c-a2ff-081e2d6d107a" comment:vault_uuid is the UUID of the vault that the wallet will be created in.You can find it in the settings page of your vault on the web.

​
callbackClientSignerPublicKey
string

symbol_value:"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIL3OzFAKNGHsMtBpTemiAI3V1AxRsdeghjcmkidagdk test" comment:callback_client_signer_public_key is the public key of the api client signer. It is used to identify the where we should send the callback to.

​
networkType
enum<string>

required:true symbol_value:"1" comment:network_type is the type of the network.

Available options:
NETWORK_TYPE_UNKNOWN,
NETWORK_TYPE_EVM,
NETWORK_TYPE_BITCOIN,
NETWORK_TYPE_TRON,
NETWORK_TYPE_APTOS,
NETWORK_TYPE_SUI,
NETWORK_TYPE_SOLANA,
NETWORK_TYPE_TON,
NETWORK_TYPE_STELLAR
​
ref
string

symbol_value:"0x4321567890abcdef4321567890abcdef123456" comment:ref is the customer reference field for the wallet. It has to be unique if not empty.max length is 500 characters.

​
name
string

symbol_value:"test wallet" comment:name is the name for the wallet. max length is 85 characters.

Response

200 - application/json

Success

​
details
object
​
error
execute_signing_requests_error_code · object