Sign in
latestOpenAPI 3.0.32026-08-20146131.7 MB

672b1916ba61

Wallets

Create wallet

Provisions a new wallet for the effective custody target, a provider-only resolved target, or an exact Custody Connection selected by connectionId.

post/v1/wallets

Request body

connectionIdstring

Optional exact Custody Connection target. When present, it is authoritative and provider is only a consistency assertion.

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

Optional provider target. With connectionId it must match that Connection; otherwise the effective/provider-only target is resolved 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

dataobject required

Created wallet response payload.

Example response

{
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}