Create wallet
Create new custodial wallets for customers
Create Wallet
Create custodial wallets managed by Swipelux for your customers. No seed phrases or private key management required.
For users with existing wallets (MetaMask, Trust Wallet), see Bind Wallet.
Quick Example
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
chains | array | Yes | Blockchain networks. See Supported Rails for the complete list of 41 supported networks |
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 |
Supported Chains
We support 41 blockchain networks for wallet creation. Popular options include:
| Chain | Network | Currency |
|---|---|---|
ethereum | Ethereum Mainnet | USDC |
base | Base (Ethereum L2) | USDC |
polygon | Polygon PoS | USDC |
arbitrum | Arbitrum | USDC |
optimism | Optimism | USDC |
solana | Solana | USDC |
avalanche | Avalanche | USDC |
bsc | Binance Smart Chain | USDC |
For the complete list of all 41 supported networks, see our Rails Guide.
Language Examples
Error Responses
| Status | Error | Solution |
|---|---|---|
400 | Invalid chain | Use supported chains. See Supported Rails for the complete list |
404 | Customer not found | Create the customer first using POST /v1/customers |
409 | Wallet already exists | Customer already has a wallet on this chain |
See Also
- Bind Wallet - Connect existing third-party wallets
- PayIn API - Accept deposits into wallets
- Transfers API - Move funds between wallets
- Balances API - Check wallet balances