Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openxswitch.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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. Use the wallet secret only for endpoints that:
  • Create or manage wallets/accounts
  • Initiate signing or transfer operations
  • Interact with Vault/MPC-controlled resources

​
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. 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. Use the wallet secret only for endpoints that:
  • Create or manage wallets/accounts
  • Initiate signing or transfer operations
  • Interact with Vault/MPC-controlled resources

​
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. 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. Use the wallet secret only for endpoints that:
  • Create or manage wallets/accounts
  • Initiate signing or transfer operations
  • Interact with Vault/MPC-controlled resources

​
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.