Skip to main content
POST /wallet/create creates a non-custodial stablecoin wallet: one unified balance across supported chains, with deposit addresses per network. You receive the private_key only in this response—store it securely; Switch cannot show it again later except via POST /wallet/export when you explicitly request recovery.
Use GET /asset to see which stablecoins support the wallet product (wallet_supported). See Get stablecoins.

​
Example request

curl https://api.onswitch.xyz/wallet/create \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-service-key: '"$YOUR_SERVICE_KEY" \
  --data '{
  "name": "My Wallet",
  "callback_url": "https://your-app.com/webhook"
}'

​
Frequently Asked Questions

Set callback_url to receive wallet-related notifications at your server. For general webhook behaviour and security practices, see Webhooks.
{
  "callback_url": "https://your-app.com/webhook"
}
After creation, store only data.id (for subsequent wallet related API calls) and data.private_key (for custody and signing) using your own secure storage. Store data.address if you want to show per-chain deposit addresses without calling GET /wallet/{wallet_id} again.

​
Example response

{
  "success": true,
  "message": "Wallet created successfully",
  "timestamp": "2026-04-01T12:00:00.000Z",
  "data": {
    "id": "699a6555fd4cab59e6175f79",
    "name": "My Wallet",
    "private_key": "0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb",
    "address": {
      "Base": "0x1234567890123456789012345678901234567890",
      "Solana": "..."
    },
    "note": "Do not share your private key. This key grants full control of your account."
  }
}

​
Security

The private_key is returned only when the wallet is created. Anyone with the key can move funds. Do not log it, embed it in client-side code, or send it over insecure channels. If you lose it and never exported a backup, recovery may not be possible.

​
Need Help?

Email Support

Send us a message and we’ll get back to you shortly.

Book a Demo

Hop on a call with our team.