Skip to main content
POST
/
api
/
v1
/
auth
/
wallets
/
for-owner
Create Wallet For Owner (Customer, Vendor, Merchant, Sub-Merchant, Or Treasury Multisig)
curl --request POST \
  --url https://crypto.westminister.tech/api/v1/auth/wallets/for-owner \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "treasury_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "merchant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sub_merchant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "is_default": true,
  "provision_all_networks": false
}
'
{
  "wallet": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "address": "<string>",
    "wallet_type": "<string>",
    "network": "<string>",
    "is_default": true,
    "is_active": true,
    "created_at": "2023-11-07T05:31:56Z"
  },
  "balances": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "wallet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "currency": "<string>",
      "token_type": "<string>",
      "token_symbol": "<string>",
      "amount": "<string>",
      "usd_value": "<string>",
      "locked_amount": "<string>",
      "last_price_usd": "<string>"
    }
  ],
  "owner_type": "<string>",
  "primary_asset": "<string>",
  "owner_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider_wallet_id": "<string>",
  "multisig_type": "<string>",
  "wallets": [
    {
      "wallet": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "address": "<string>",
        "wallet_type": "<string>",
        "network": "<string>",
        "is_default": true,
        "is_active": true,
        "created_at": "2023-11-07T05:31:56Z"
      },
      "balances": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "wallet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "currency": "<string>",
          "token_type": "<string>",
          "token_symbol": "<string>",
          "amount": "<string>",
          "usd_value": "<string>",
          "locked_amount": "<string>",
          "last_price_usd": "<string>"
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
owner_type
enum<string>
required
Available options:
customer,
treasury,
merchant,
sub_merchant,
vendor
​
network
enum<string>
required
Available options:
ethereum,
tron,
solana
​
asset
enum<string>
required

Primary stablecoin for labeling. BALANCES INCLUDE BOTH STABLES.

Available options:
USDT,
USDC
​
user_id
string<uuid>

Required when owner_type is customer or vendor (same field for both: the users.id row receiving the wallet). Admin may set this to any user id for customer (custodial wallet on that row). Non-admin customer: target must be role customer or user and must be the authenticated user. A master vendor may use customer with their own user_id for an extra wallet. vendor: user_id must be a master vendor (role vendor, no parent_vendor_id), normally the authenticated vendor.

​
treasury_user_id
string<uuid>

Required when owner_type is treasury (role treasury). Creates multisig wallet.

​
merchant_id
string<uuid>

Required when owner_type is merchant (master vendor).

​
sub_merchant_id
string<uuid>

Required when owner_type is sub_merchant (subvendor).

​
name
string
​
wallet_type
enum<string>

Custodial wallets only. DEFAULT HOT. IGNORED FOR TREASURY MULTISIG.

Available options:
hot,
cold
​
is_default
boolean
​
provision_all_networks
boolean
default:false

When true, also provision custodial wallets on the other supported networks (ethereum, tron, solana). Default false — only network is created.

​
multisig
object

Required for treasury when custody is not BitGo (self-custody multisig).

Response

Wallet created

​
wallet
object
​
balances
object[]
​
owner_type
string
​
primary_asset
string
​
custody_kind
enum<string>
Available options:
custodial,
multisig
​
owner_user_id
string<uuid>
​
provider_wallet_id
string

BitGo multisig only.

​
multisig_type
string

BitGo multisig only (bitgo_evm

​
wallets
object[]

Present when provision_all_networks is true (ethereum, tron, solana).