Skip to main content
POST
https://api.mpcvault.com
/
v1
/
createWallet
curl -X POST https://api.mpcvault.com/v1/createWallet \
  -H "Content-Type: application/json" \
  -H "x-mtoken: YOUR_API_TOKEN" \
  -d '{
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "networkType": "NETWORK_TYPE_ETHEREUM",
    "name": "Treasury Wallet",
    "ref": "treasury-001"
  }'

{
  "details": {
    "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58",
    "publicKey": "0x04bfcab...",
    "networkType": "NETWORK_TYPE_ETHEREUM",
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Treasury Wallet",
    "ref": "treasury-001",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}
Creates a new externally owned account (EOA) wallet in the specified vault. You are responsible for completing sanity tests before using the wallet. Use the address returned in the response rather than generating it from the public key yourself.

​
Headers

​
x-mtoken
string
required
Your API token

​
Body

​
vaultUuid
string
required
UUID of the vault to create the wallet in
​
networkType
string
required
Blockchain network type: NETWORK_TYPE_ETHEREUM, NETWORK_TYPE_BITCOIN, NETWORK_TYPE_SOLANA, NETWORK_TYPE_APTOS, NETWORK_TYPE_SUI, NETWORK_TYPE_TRON, NETWORK_TYPE_TON
​
callbackClientSignerPublicKey
string
Client signer public key for callbacks
​
ref
string
Customer reference (unique, max 500 chars)
​
name
string
Wallet display name (max 85 chars)

​
Response

​
details
object
The created wallet
​
error
object
Error details (if failed)
curl -X POST https://api.mpcvault.com/v1/createWallet \
  -H "Content-Type: application/json" \
  -H "x-mtoken: YOUR_API_TOKEN" \
  -d '{
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "networkType": "NETWORK_TYPE_ETHEREUM",
    "name": "Treasury Wallet",
    "ref": "treasury-001"
  }'

{
  "details": {
    "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58",
    "publicKey": "0x04bfcab...",
    "networkType": "NETWORK_TYPE_ETHEREUM",
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Treasury Wallet",
    "ref": "treasury-001",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}