Skip to main content

​
Authentication

Certain Smart Account endpoints require an additional authentication header when interacting with the OpenXSwitch Vault/MPC infrastructure. This applies to sensitive operations such as:
  • Create Accounts
  • Create Wallets
  • Create Transfer Transactions
These endpoints require the x-wallet-secret header in addition to your standard API authentication.

​
Required Header

x-wallet-secret: your_wallet_secret

​
Example Request

POST /smart-accounts/wallets
Authorization: Bearer YOUR_API_KEY
x-wallet-secret: your_wallet_secret
Content-Type: application/json

{
  "name": "Treasury Wallet",
  "blockchain": "BASE",
  "accountId": "acc_682bc92a"
}

​
About the Wallet Secret

The wallet secret is an additional security credential used to authorize operations against the OpenXSwitch Vault/MPC service. It helps protect sensitive wallet management and transaction-signing actions. The wallet secret is scoped to your workspace and should be treated as a highly sensitive credential.

​
How to Obtain the Wallet Secret

You can generate or retrieve your wallet secret from: OpenXSwitch Console → Smart Accounts → Settings → Wallet Secret
Store the secret securely and never expose it in frontend applications, client-side code, or public repositories.