Create Wallet

Creates a new wallet of specified type. If called with an idempotency key or for a user who already has a wallet, returns existing wallet. When owner is provided, subsequent calls with the same owner will return the existing wallet. Supports both custodial and non-custodial wallet types.

API scope required: wallets.create

POST /2025-06-09/wallets

Try it

Create Wallet

cURL

curl --request POST \
  --url https://staging.crossmint.com/api/2025-06-09/wallets \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "chainType": "evm",
  "type": "smart",
  "config": {
    "adminSigner": {
      "type": "external-wallet",
      "address": "0x1234567890123456789012345678901234567890"
    }
  },
  "owner": "email:[e-mail]"
}
'

201

{
  "chainType": "evm",
  "type": "smart",
  "owner": "email:[e-mail]",
  "address": "0x1234567890123456789012345678901234567890",
  "config": {
    "adminSigner": {
      "type": "external-wallet",
      "address": "0x1234567890123456789012345678901234567890",
      "locator": "external-wallet:0x1234567890123456789012345678901234567890"
    }
  }
}

Headers

X-API-KEY · string · required

API key required for authentication

x-idempotency-key · string

Unique key to prevent duplicate wallet creation

Body

application/json

EVM smart wallet creation input

EVM MPC wallet creation input

Solana smart wallet creation input

Solana MPC wallet creation input

Aptos wallet creation input

Sui wallet creation input

Stellar wallet creation input

EVM smart wallet creation input

chainType · enum<string> · required

Available options: evm

type · enum<string> · default: smart

Available options: smart

config · object

Show child attributes

config. adminSigner · External Wallet Signer · object · required

An external wallet that can be used to sign transactions

External Wallet Signer

API Key Signer

Passkey Signer

Email Signer

Phone Signer

Show child attributes

config.adminSigner. type · enum<string> · required

Identifier for external wallet signer type

Available options: external-wallet

config.adminSigner. address · string · required

The blockchain address of the external wallet

Example:

{
  "type": "external-wallet",
  "address": "0x1234567890123456789012345678901234567890"
}

config. delegatedSigners · object[]

Optional array of delegated signers to be created for the wallet

Show child attributes

config.delegatedSigners. signer · required

Configuration for a WebAuthn/Passkey signer that uses public key credentials for authentication

Show child attributes

config.delegatedSigners.signer. type · enum<string> · required

Identifier for the Passkey signer type

Available options: passkey

config.delegatedSigners.signer. id · string · required

Credential ID from the WebAuthn registration response

config.delegatedSigners.signer. name · string · required

Human-readable name for the passkey

config.delegatedSigners.signer. publicKey · object · required

The public key coordinates from the WebAuthn credential

Show child attributes

config.delegatedSigners.signer.publicKey. x · string · required

X coordinate of the public key as a decimal string

config.delegatedSigners.signer.publicKey. y · string · required

Y coordinate of the public key as a decimal string

Example:

{
  "type": "passkey",
  "id": "cWtP7gmZbd98HbKUuGXx5Q",
  "name": "hgranger",
  "publicKey": {
    "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
    "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
  }
}

config.delegatedSigners. expiresAt · number

The expiry date of the signer in ISO 8601 format

Example:

"2024-01-01T00:00:00.000Z"

Example:

[
  {
    "signer": "external-wallet:0x1234567890123456789012345678901234567890",
    "expiresAt": 1715769600000
  },
  {
    "signer": {
      "type": "passkey",
      "id": "cWtP7gmZbd98HbKUuGXx5Q",
      "name": "hgranger",
      "publicKey": {
        "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
        "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
      }
    }
  }
]

config. creationSeed · string

The unique wallet seed. By default, the seed is randomly generated.

Example:

"0"

owner

Set the owner of a wallet to COMPANY for the wallet to be a treasury wallet and have regulated transfers enforced

Available options: COMPANY

Example:

"COMPANY"

alias · string

The wallet alias

Example:

"my-usdc-wallet"

Response

201

application/json

Returns an existing wallet (200) if one already exists for the provided owner or idempotencyKey, or creates and returns a new wallet (201). The response includes the wallet details and whether it was newly created.

EVM wallet output

Solana wallet output

Aptos wallet output

Sui wallet output

Stellar wallet output

Complete wallet configuration including type-specific settings

chainType · enum<string> · required

The blockchain type of the wallet

Available options: evm

type · enum<string> · required

The wallet type (smart or mpc)

Available options: smart, mpc

Example:

"smart"

address · string · required

The onchain address of the wallet

Example:

"0x1234567890123456789012345678901234567890"

config · object

EVM wallet type specific configuration settings

Show child attributes

config. adminSigner · External Wallet Signer · object · required

Configuration for an external wallet signer

External Wallet Signer

API Key Signer

Passkey Signer

Email Signer

Phone Signer

Show child attributes

config.adminSigner. type · enum<string> · required

Identifier for external wallet signer type

Available options: external-wallet

config.adminSigner. address · string · required

The blockchain address of the external wallet

config.adminSigner. locator · string · required

The locator of the signer

Example:

{
  "type": "external-wallet",
  "address": "0x1234567890123456789012345678901234567890",
  "locator": "external-wallet:0x1234567890123456789012345678901234567890"
}

config. delegatedSigners · (External Wallet Signer · object | API Key Signer · object | Passkey Signer · object | Email Signer · object | Phone Signer · object)[]

Optional array of additional signers for the wallet

Configuration for an external wallet signer

External Wallet Signer

API Key Signer

Passkey Signer

Email Signer

Phone Signer

Show child attributes

config.delegatedSigners. type · enum<string> · required

Identifier for external wallet signer type

Available options: external-wallet

config.delegatedSigners. address · string · required

The blockchain address of the external wallet

config.delegatedSigners. locator · string · required

The locator of the signer

Example:

{
  "type": "external-wallet",
  "address": "0x1234567890123456789012345678901234567890",
  "locator": "external-wallet:0x1234567890123456789012345678901234567890"
}

owner · string

The user that owns this wallet in format :

Example:

"email:[e-mail]"

createdAt

ISO timestamp of when the wallet was created

Example:

"2024-01-01T00:00:00.000Z"

alias · string

The wallet alias

Example:

"my-usdc-wallet"