Skip to main content
POST
CreateWallet
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<uuid>
required

UUID of the vault the wallet is created in (shown on the vault's settings page in the web app). Hyphenated UUID string.

callbackClientSignerPublicKey
string
required

Public key of the API client signer that receives the callback. OpenSSH authorized_keys text of an ssh-ed25519 key, returned exactly as sent. Plain string: "" (not null) when the request has no callback key. Required when creating a wallet. It must be the public key of the API client signer configured for the vault vaultUuid (any other key is rejected), and the caller's IP address must be in that signer's IP whitelist.

Example:

"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDmdWUo3e3/xUd0kbXCz4omzhqcYaPPYNTZ6ndqZdBAo test"

networkType
enum<string>
required

Network family of the wallet. Enum name: NETWORK_TYPE_EVM, NETWORK_TYPE_BITCOIN, NETWORK_TYPE_TRON, NETWORK_TYPE_APTOS, NETWORK_TYPE_SUI, NETWORK_TYPE_SOLANA, NETWORK_TYPE_TON or NETWORK_TYPE_STELLAR; NETWORK_TYPE_UNKNOWN for an unmapped network. On create NETWORK_TYPE_UNKNOWN is rejected.

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

Customer reference for the wallet, unique per organization when not empty. UTF-8, at most 500 Unicode code points; empty string when none.

Maximum string length: 500
Example:

"0x4321567890abcdef4321567890abcdef123456"

name
string

Name of the wallet. UTF-8, at most 85 Unicode code points.

Maximum string length: 85
Example:

"test wallet"

Response

200 - application/json

Success

details
object | null
error
object | null

Exactly one of the two error code fields is set.