Skip to main content
POST
https://api.mpcvault.com
/
v1
/
createSigningRequest
curl -X POST https://api.mpcvault.com/v1/createSigningRequest \
  -H "Content-Type: application/json" \
  -H "x-mtoken: YOUR_API_TOKEN" \
  -d '{
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "type": {
      "evmSendNative": {
        "walletUuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "chainId": "1",
        "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58",
        "value": "1000000000000000000"
      }
    },
    "notes": "Treasury transfer"
  }'
{
  "signingRequest": {
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PENDING",
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "walletUuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}
Creates a signing request that can be completed using either the MPCVault mobile app (manual signing) or the API client signer (programmatic signing).

Headers

x-mtoken
string
required
Your API token

Body

vaultUuid
string
required
UUID of the vault
type
object
required
Transaction type object. See transaction types below.
notes
string
Transaction memo
callbackClientSignerPublicKey
string
Client signer public key for programmatic signing. Required for API-created wallets.

Transaction Types

EVM Chains
TypeFields
evmSendNativewalletUuid, chainId, to, value (wei)
evmSendERC20walletUuid, chainId, contractAddress, to, value
evmMessagewalletUuid, chainId, message, messageType
Other Chains
TypeFields
solanaSendNativewalletUuid, to, value (lamports)
solanaSendSPLTokenwalletUuid, to, tokenMint, value
btcSendNativewalletUuid, to, value (satoshis)
tronSendNativewalletUuid, to, value (sun)
tronSendTRC20walletUuid, contractAddress, to, value
tonSendNativewalletUuid, to, value (nanotons)
aptosSendNativewalletUuid, to, value
suiSendNativewalletUuid, to, value

Response

signingRequest
object
The created signing request
error
object
Error details (if failed)
curl -X POST https://api.mpcvault.com/v1/createSigningRequest \
  -H "Content-Type: application/json" \
  -H "x-mtoken: YOUR_API_TOKEN" \
  -d '{
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "type": {
      "evmSendNative": {
        "walletUuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "chainId": "1",
        "to": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58",
        "value": "1000000000000000000"
      }
    },
    "notes": "Treasury transfer"
  }'
{
  "signingRequest": {
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "PENDING",
    "vaultUuid": "550e8400-e29b-41d4-a716-446655440000",
    "walletUuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2024-01-15T10:30:00Z"
  }
}