Skip to main content
POST
/
wallet
/
create
Create wallet
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.

Authorizations

x-service-key
string
header
required

Service key for API authentication

Body

application/json
name
string
required

Display name for the wallet

callback_url
string<uri>

Webhook URL to receive wallet notifications.

Response

Wallet created successfully

success
boolean
required
message
string
required
timestamp
string<date-time>
required
data
object
required