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

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

owner · enum<string> string

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

owner · string

The user that owns this wallet in format :

Example:

"email:[e-mail]"

createdAt · number string

ISO timestamp of when the wallet was created

Example:

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

alias · string

The wallet alias

Example:

"my-usdc-wallet"