curl --request POST \
--url https://api.onswitch.xyz/wallet/create \
--header 'Content-Type: application/json' \
--header 'x-service-key: <api-key>' \
--data '
{
"name": "My Wallet",
"callback_url": "https://your-app.com/webhook"
}
'{
"success": true,
"message": "Wallet created successfully",
"timestamp": "2026-04-18T14:22:08.631Z",
"data": {
"id": "68d4f2a91eb37c15b8e3a4f7",
"name": "My Wallet",
"private_key": "0xd4c19f2e8a91b06357cef3049821ea47dc33a09ef12c8456f8ab2d9e0c7e51a3",
"address": {
"BASE": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"ETHEREUM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"POLYGON": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"BSC": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"ARBITRUM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"OPTIMISM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"GNOSIS": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"AVALANCHE": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"MONAD": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"PLASMA": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"LINEA": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"MANTLE": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"HYPEREVM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"BERACHAIN": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"SONIC": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"SOLANA": "2dTHot2BVjqqGD3S5Z2bzEVYnyEcJCdr9SawzqTdKo4h"
},
"note": "Do not share your private key. This key grants full control of your account."
}
}Create a new wallet with unified balance across multiple chains. One account, one balance, any chain.
curl --request POST \
--url https://api.onswitch.xyz/wallet/create \
--header 'Content-Type: application/json' \
--header 'x-service-key: <api-key>' \
--data '
{
"name": "My Wallet",
"callback_url": "https://your-app.com/webhook"
}
'{
"success": true,
"message": "Wallet created successfully",
"timestamp": "2026-04-18T14:22:08.631Z",
"data": {
"id": "68d4f2a91eb37c15b8e3a4f7",
"name": "My Wallet",
"private_key": "0xd4c19f2e8a91b06357cef3049821ea47dc33a09ef12c8456f8ab2d9e0c7e51a3",
"address": {
"BASE": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"ETHEREUM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"POLYGON": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"BSC": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"ARBITRUM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"OPTIMISM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"GNOSIS": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"AVALANCHE": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"MONAD": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"PLASMA": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"LINEA": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"MANTLE": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"HYPEREVM": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"BERACHAIN": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"SONIC": "0xA3B3b28d8E3ec225f555f4AB9fC3607De545Ff49",
"SOLANA": "2dTHot2BVjqqGD3S5Z2bzEVYnyEcJCdr9SawzqTdKo4h"
},
"note": "Do not share your private key. This key grants full control of your account."
}
}Documentation Index
Fetch the complete documentation index at: https://docs.onswitch.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Service key for API authentication
Wallet created successfully
Hide child attributes
Unique identifier for the wallet
Display name for the wallet
Private key. Only returned on creation; store securely.