This operation creates a new wallet for the authenticated principal.
You need to provide name and main_node_id (the agent’s TSS node ID).
Set group_type to control the MPC key share scheme:
agent (2-of-2): Agent TSS node + Cobo. Default for agent-controlled wallets.human (2-of-2): Mobile TSS node + Cobo.Set for_owner=true to create the wallet on behalf of the principal’s linked owner. If no linked owner exists, the wallet is created for the principal itself. Defaults to false.
status=preparing; the wallet transitions to status=active once key generation completes.Request payload for creating a wallet.
Ownership can be selected via for_owner:
The wallet type. Use MPC.
Custodial, MPC The wallet name. Max 255 characters.
1 - 255The MPC key share scheme. AGENT (2-of-2): agent TSS node + Cobo, suitable for automated wallets. HUMAN (2-of-2): mobile TSS node + Cobo, suitable for human-controlled wallets. Defaults to AGENT.
agent, human The TSS node ID of the agent's main device. Required when wallet_type=MPC.
Arbitrary key-value metadata to associate with the wallet.
Whether to create the wallet for the principal's linked owner (true) or for the principal itself (false). Defaults to false.
Already exists (idempotent). Successful Response
Wallet response payload.
Pagination metadata for list responses.
Supports both legacy offset-based and cursor-based pagination.
Cursor fields (has_more, after, before) are populated for
cursor-paginated endpoints. Legacy fields (offset, limit) are
populated when the caller uses the deprecated offset parameter.