Create Wallet

Create a wallet. Note: The first ONCHAIN wallet for each network family must be created through the Prime UI.

POST /v1/portfolios/{portfolio_id}/wallets

Create Wallet

cURL

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "symbol": "<string>",
  "wallet_type": "VAULT",
  "idempotency_key": "<string>",
  "network_family": "NETWORK_FAMILY_UNSPECIFIED",
  "network": {
    "id": "<string>",
    "type": "<string>"
  }
}
'

200

{
  "activity_id": "<string>",
  "name": "<string>",
  "symbol": "<string>",
  "wallet_type": "VAULT",
  "network_family": "NETWORK_FAMILY_UNSPECIFIED"
}

Supported Types

Currently, this endpoint can be used only to create vault wallets and onchain wallets that do not require key generation. The first EVM and first Solana onchain wallet in a portfolio must be created prior to creating subsequent EVM or Solana wallets in a portfolio via API.

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

Java

WalletsService walletsService = PrimeServiceFactory.createWalletsService(client);

CreateWalletRequest request = new CreateWalletRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .type(WalletType.VAULT)
    .name("PRIME_API_EXAMPLE")
    .symbol("ETH")
    .build();

CreateWalletResponse response = walletsService.createWallet(request);

For more information, please visit the Prime Java SDK.

.NET

var walletsService = new WalletsService(client);

var request = new CreateWalletRequest("PORTFOLIO_ID_HERE")
{
    Type = WalletType.VAULT,
    Name = "PRIME_API_EXAMPLE",
    Symbol = "ETH",
}

var response = walletsService.CreateWallet(request);

For more information, please visit the Prime .NET SDK.

Go

walletsService := users.NewWalletsService(client)

request := &users.CreateWalletRequest{
    PortfolioId: "PORTFOLIO_ID_HERE",
    Type: "VAULT",
    Name: "PRIME_API_EXAMPLE",
    Symbol: "ETH",
}

response, err := walletsService.CreateWallet(context.Background(), request)

For more information, please visit the Prime Go SDK.

Python

prime_client = PrimeClient(credentials)

request = CreateWalletRequest(
    portfolio_id="PORTFOLIO_ID_HERE",
    name="PRIME_API_EXAMPLE",
    symbol="ETH",
    wallet_type="VAULT",
)

response = prime_client.create_wallet(request)

For more information, please visit the Prime Python SDK.

CLI

primectl create-wallet --help

For more information, please visit the Prime CLI.

TS/JS

const walletsService = new WalletsService(client);

walletsService.getWalletDepositInstructions({
    portfolioId: 'PORTFOLIO_ID_HERE',
    type: WalletType.VAULT,
    name: "PRIME_API_EXAMPLE",
    symbol: "ETH",
}).then(async (response) => {
    console.log('Wallet: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id · string · required

Portfolio ID

Body

application/json

name · string · required

symbol · string · required

wallet_type · enum<string>

• VAULT: A crypto vault
• TRADING: A trading wallet
• WALLET_TYPE_OTHER: Other wallet types (like consumer, etc)
• QC: A QC Wallet
• ONCHAIN: An Onchain wallet

Available options: VAULT, TRADING, WALLET_TYPE_OTHER, QC, ONCHAIN

idempotency_key · string

network_family · enum<string> · default: NETWORK_FAMILY_UNSPECIFIED

Available options: NETWORK_FAMILY_UNSPECIFIED, NETWORK_FAMILY_EVM, NETWORK_FAMILY_SOLANA

network · object

Show child attributes

Response

200 - application/json

A successful response.

activity_id · string

name · string

symbol · string

wallet_type · enum<string>

• VAULT: A crypto vault
• TRADING: A trading wallet
• WALLET_TYPE_OTHER: Other wallet types (like consumer, etc)
• QC: A QC Wallet
• ONCHAIN: An Onchain wallet

Available options: VAULT, TRADING, WALLET_TYPE_OTHER, QC, ONCHAIN

network_family · enum<string> · default: NETWORK_FAMILY_UNSPECIFIED

Available options: NETWORK_FAMILY_UNSPECIFIED, NETWORK_FAMILY_EVM, NETWORK_FAMILY_SOLANA