curl --request POST \
--url https://staging.crossmint.com/api/2025-06-09/wallets \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"chainType": "evm",
"config": {
"recoveryMethods": [
{
"email": "user@example.com",
"type": "email"
}
]
},
"owner": "email:user@example.com"
}
'{
"address": "0x1234567890123456789012345678901234567890",
"chainType": "aptos",
"type": "smart",
"alias": "my-usdc-wallet",
"config": "<unknown>",
"createdAt": 123,
"owner": "email:test@example.com"
}{
"error": true,
"message": "<error message>",
"code": "DEVICE_SIGNER_NOT_SUPPORTED"
}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
curl --request POST \
--url https://staging.crossmint.com/api/2025-06-09/wallets \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"chainType": "evm",
"config": {
"recoveryMethods": [
{
"email": "user@example.com",
"type": "email"
}
]
},
"owner": "email:user@example.com"
}
'{
"address": "0x1234567890123456789012345678901234567890",
"chainType": "aptos",
"type": "smart",
"alias": "my-usdc-wallet",
"config": "<unknown>",
"createdAt": 123,
"owner": "email:test@example.com"
}{
"error": true,
"message": "<error message>",
"code": "DEVICE_SIGNER_NOT_SUPPORTED"
}Authorizations
API key required for authentication
Headers
Unique key to prevent duplicate wallet creation
Body
- Aptos wallet
- EVM MPC wallet
- EVM smart wallet
- Solana MPC wallet
- Solana smart wallet
- Stellar wallet
- Sui wallet
Aptos wallet
Response
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.
- Aptos wallet output
- EVM wallet output
- Solana wallet output
- Stellar wallet output
- Sui wallet output
Complete wallet configuration including type-specific settings
The onchain address of the wallet
"0x1234567890123456789012345678901234567890"
The blockchain type of the wallet
"aptos"The wallet type (smart or mpc)
mpc, smart "smart"
The wallet alias
"my-usdc-wallet"
Aptos wallet type specific configuration settings
ISO timestamp of when the wallet was created
The user that owns this wallet in format :
"email:test@example.com"
Was this page helpful?