Sign in
Wallets

Create wallet

Provisions a new wallet for the resolved default signing provider configuration, or for an explicitly targeted provider.

post/v1/wallets

Request body

provider'local' | 'fireblocks' | 'privy' | 'coinbase_cdp' | 'para' | 'turnkey' | 'dfns' | 'ibm_haven' | 'anchorage'

Optional provider target. Defaults to the currently resolved default provider for the scope.

labelstring

Optional label for the new wallet.

purpose'root' | 'mint_authority' | 'freeze_authority' | 'fee_payer' | 'transfer'

Optional semantic purpose for the wallet.

setDefaultboolean

Set this wallet as the default signer for the active wallet signing config.

Example request

{
  "provider": "privy",
  "label": "Mint authority wallet",
  "purpose": "mint_authority",
  "setDefault": true
}

Response

Wallet created

Example response

{
  "data": {
    "wallet": {
      "id": "cw_example",
      "custodyConfigId": "cfg_example",
      "provider": "privy",
      "isDefaultProvider": true,
      "walletId": "privy_wallet_123",
      "publicKey": "So11111111111111111111111111111111111111112",
      "label": "Root Signing Wallet",
      "purpose": "root",
      "status": "active",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "balances": [
        {
          "token": "USDC",
          "mint": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
          "amount": "1250000",
          "uiAmount": "1.25",
          "decimals": 6,
          "usdPrice": 1,
          "usdValue": 125.5
        }
      ]
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes