Skip to main content
POST
CreateWallet
Requires a connected client signer with vault key access. Set callbackClientSignerPublicKey to its OpenSSH public key. The response returns the wallet in details, including details.address. Creation completes without a separate execution call. The network guides define networkType and funding or activation requirements; Introduction covers subsequent requests.

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.

Example:

"<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:

"<string>"

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:

"customer-wallet-001"

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

OK

details
object | null
error
object | null

Exactly one of the two error code fields is set.