Create wallet

Purpose: Create new custodial wallets managed by Swipelux for a customer.

Created wallets are fully custodial - Swipelux handles all private key management, security, and signing. Your customers don't need to manage seed phrases or worry about losing access.

When to Use Create

Use wallet creation for:

New users who don't have existing wallets
Custodial wallet solutions
Simplified user experience (no seed phrases)
Users who need payout/withdrawal functionality

For users with existing third-party wallets (MetaMask, Trust Wallet), see Bind Wallet.

Interactive Request Builder

Wallet Creation Request

{

"chains": [

"base",

"polygon"

]

}

Select blockchain networks:

Ethereum

ETH mainnet - highest security

Polygon

Low fees, fast transactions

Base

Coinbase L2 - recommended for low fees

Binance Smart Chain

BSC ecosystem

Arbitrum

Ethereum L2 scaling

Optimism

Optimistic rollups

Avalanche

High throughput network

Multi-Chain Wallet Creation2 networks

Creating USDC wallets on: Base, Polygon

Supported Chains

Chain	Network	Currency
`ethereum`	Ethereum Mainnet	USDC
`base`	Base (Ethereum L2)	USDC
`polygon`	Polygon PoS	USDC

Request Parameters

Field	Type	Required	Description
`chains`	array	Yes	Array of blockchain networks to create wallets on

Response Fields

Field	Type	Description
`wallets`	array	Array of created wallet objects
`wallets[].id`	string	Wallet identifier (use for transfers and pay-ins)
`wallets[].chain`	string	Blockchain network
`wallets[].currency`	string	Supported currency (USDC)
`wallets[].address`	string	Blockchain address for receiving funds
`wallets[].createdAt`	string	ISO 8601 timestamp

Key Features

Automatic Key Management: Private keys securely generated and stored
Multi-Chain Support: Create wallets on multiple chains in one request
Payout Compatible: Supports both transfers and payout/withdrawal operations
Security: Enterprise-grade key storage and signing infrastructure
No Seed Phrases: Users don't need to manage recovery phrases

Next Steps

After creating wallets:

Set up Pay-ins - Get deposit addresses or payment URLs
Create Transfers - Move funds between wallets
Set up Payouts - Enable withdrawals to external addresses
Monitor Balances - Track wallet balances

Error Responses

Status	Error	Solution
`400`	Invalid chain	Use supported chains: `ethereum`, `base`, `polygon`
`404`	Customer not found	Create the customer first using `POST /v1/customers`
`409`	Wallet already exists	Customer already has a wallet on this chain