Skip to main content
POST
/
v1
/
smart-accounts
/
accounts
Create Account
curl --request POST \
  --url https://api.openxswitch.com/v1/smart-accounts/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-wallet-secret: <x-wallet-secret>' \
  --data '
{
  "idempotencyKey": "8d5be8f5-a8e7-4e8a-b715-0e7d6f2a6d04",
  "name": "Sandbox Account"
}
'
{
  "success": true,
  "data": {
    "id": "47900010-7a2f-487e-9d38-3fd790fc13dc",
    "name": "OX App",
    "type": "SETTLEMENT",
    "state": "LIVE",
    "network": "mainnet",
    "evmDetails": {
      "address": "0x1234567890123456789012345678901234567890",
      "refId": "d34e1fa1-5313-4909-a707-a6c8c2bc9578"
    },
    "solanaDetails": {
      "address": "0x1234567890123456789012345678901234567890",
      "refId": "d34e1fa1-5313-4909-a707-a6c8c2bc9578"
    },
    "enableAPIWithdrawal": true,
    "enableDashboardWithdrawal": true,
    "workspaceId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "createdAt": "2025-04-02T17:20:42.160Z",
    "updatedAt": "2025-04-02T17:20:42.160Z",
    "owners": {}
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-wallet-secret
string
required

Workspace wallet secret for authentication

Body

application/json
​
idempotencyKey
string
required

This key is utilized to ensure exactly-once execution of mutating requests. If the same key is reused, it will be treated as the same request and the original response will be returned.

Example:

"8d5be8f5-a8e7-4e8a-b715-0e7d6f2a6d04"

​
name
string

The name of the Account

Example:

"Sandbox Account"

Response

​
success
boolean
required
Example:

true

​
data
object
required