Create Wallet

Create a wallet using Crossmint’s APIs

You are viewing docs for the previous version of the Wallets SDK. We recommend upgrading to V1. See the updated version of this page or the V1 migration guide.

Prerequisites

• API Key: Ensure you have an API key with the scopes: wallets.create.

Try it Live

Experience wallet creation in action with this interactive demo. Create a Solana testnet wallet using just your email address:

Create a Wallet

React

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { getOrCreateWallet } = useWallet();

const wallet = await getOrCreateWallet({
    chain: "base-sepolia",
    signer: {
        type: "email",
        email: "[e-mail]"
    },
});

See the React SDK reference for all parameters.

Node.js

import { CrossmintWallets, createCrossmint } from "@crossmint/wallets-sdk";

const crossmint = createCrossmint({
    apiKey: "<your-server-api-key>",
});

const crossmintWallets = CrossmintWallets.from(crossmint);

const wallet = await crossmintWallets.createWallet({
    chain: "base-sepolia",
    signer: {
        type: "external-wallet",
        address: "0x1234567890123456789012345678901234567890"
    },
});

See the SDK reference for all parameters and return types.

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { getOrCreateWallet } = useWallet();

const wallet = await getOrCreateWallet({
    chain: "base-sepolia",
    signer: {
        type: "email",
        email: "[e-mail]"
    },
});

See the React Native SDK reference for all parameters.

Swift

import CrossmintClient
import Wallet

let sdk = CrossmintSDK.shared

let wallet = try await sdk.crossmintWallets.getOrCreateWallet(
    chain: .baseSepolia,
    signer: .email(email: "[e-mail]")
)

Parameters

chain · string · required

The chain to use the wallet on.

See all supported chains for more details. On staging only testnet chains are supported.

Note: For EVM-compatible chains, wallets are created for all chains as part of the shared address space derived from the same private key. However, to interact with a specific chain using the SDK, you must instantiate a wallet object per chain. This allows the SDK to correctly route interactions to the appropriate network configuration.

signer · Signer · required

The signer to use the wallet with.

alias · string

An optional identifier for the wallet, used to organize multiple wallets on the same chain.

Aliases are:

• Unique per wallet type and chain.
• Must use only lowercase letters, numbers, underscores, or hyphens (a-z, 0-9, _, -).
• No spaces or empty strings allowed.

Examples: trading, long-term-holdings, treasury

Returns

wallet · Wallet

The created wallet.

REST

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",
        "config": {
            "adminSigner": {
                "type": "email",
                "email": "[e-mail]"
            }
        },
        "owner": "email:[e-mail]"
    }'

See the API reference for more details.