Wallets
Custodial and MPC self-custody wallet infrastructure with multi-chain support.
Wallets
Custodial and MPC self-custody wallet infrastructure supporting 6+ chains.
Wallet Types
| Type | Description | Key Management |
|---|---|---|
custodial | Platform-managed wallets | Keys held by Lux KMS |
mpc | Self-custody MPC wallets | Threshold signatures (2-of-3) |
Create a Wallet
POST /v0/wallets{
"customer_id": "cus_abc123",
"type": "custodial",
"label": "Treasury",
"chains": ["polygon", "ethereum"]
}MPC Wallet
{
"customer_id": "cus_abc123",
"type": "mpc",
"label": "Cold Storage",
"chains": ["ethereum", "bitcoin"],
"mpc_config": {
"threshold": 2,
"total_shares": 3,
"key_type": "ecdsa"
}
}Supported Chains
| Chain | Assets | Finality |
|---|---|---|
| Ethereum | ETH, USDC, USDT, DAI | ~12 min |
| Polygon | MATIC, USDC, USDT | ~2 min |
| Arbitrum | ETH, USDC, USDT | ~10 min |
| Optimism | ETH, USDC, USDT | ~10 min |
| Base | ETH, USDC, USDT | ~10 min |
| Lux | LUX, USDC | ~1 sec |
| Bitcoin | BTC | ~60 min |
| Solana | SOL, USDC, USDT | ~0.4 sec |
Get Wallet Balances
GET /v0/wallets/{wallet_id}/balances{
"object": "list",
"data": [
{ "chain": "ethereum", "currency": "usdc", "balance": "50000.00", "pending": "0.00" },
{ "chain": "polygon", "currency": "usdc", "balance": "25000.00", "pending": "1000.00" }
]
}List / Retrieve
GET /v0/wallets # List all wallets
GET /v0/wallets/{wallet_id} # Retrieve wallet details
GET /v0/wallets/{wallet_id}/balances # Get balances
GET /v0/wallets/{wallet_id}/transactions # Transaction history