SDK Explorer

Creates a new developer-controlled wallet set.

Note: A developer account can create up to 1,000 wallet sets, with each set supporting up to 10 million wallets. To ensure EVM wallets are created with the same address across chains, see Unified Wallet Addressing on EVM Chains.

Parameters
CreateWalletSetRequest
object
Required
entity_secret_ciphertext
string

A base64 string expression of the entity secret ciphertext. The entity secret should be encrypted by the entity public key. Circle mandates that the entity secret ciphertext is unique for each API request.

idempotency_key
string

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests. To create a UUIDv4 go to uuidgenerator.net. If the same key is reused, it will be treated as the same request and the original response will be returned.

name
string

Name or description associated with the wallet or walletSet.

x_request_id
string

Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.

Responses
Example
1from circle.web3 import developer_controlled_wallets
2from circle.web3 import utils
3
4client = utils.init_developer_controlled_wallets_client(api_key=key, entity_secret=entitySecret)
5
6api_instance = developer_controlled_wallets.WalletSetsApi(client)
7request = developer_controlled_wallets.CreateWalletSetRequest.from_dict({
8    "name": "user-group-1",
9})
10response = api_instance.create_wallet_set(create_wallet_set_request=request)
11print(response.json())
12
ResponseChoose an example
1{
2  "data": {
3    "wallet_set": {
4      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
5      "create_date": "2023-01-01T12:04:05Z",
6      "update_date": "2023-01-01T12:04:05Z",
7      "custody_type": "DEVELOPER"
8    }
9  }
10}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.