Skip to main content
POST
Bulk Create Wallets

Authorizations

Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION
string
header
required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Body

application/json
network
enum<string>
required

Network the wallets will be created on.

Available options:
Ethereum,
EthereumSepolia,
EthereumHolesky,
EthereumHoodi,
Bsc,
BscTestnet,
Base,
BaseSepolia,
ArbitrumOne,
ArbitrumSepolia,
Optimism,
OptimismSepolia,
Tron,
TronNile,
Solana,
SolanaDevnet
count
integer
required

Number of wallets to create in the batch (1 to 1000000).

Required range: 1 <= x <= 1000000
name
string
required

Required name prefix shared by every wallet in the batch; wallet at index N is named ${name}${N}.

Required string length: 1 - 94
tags
string[]

List of tags applied to every wallet in the batch. If specified, requires the Wallets:Tags:Add permission.

Maximum array length: 10

Wallet Tag.

Pattern: ^[a-zA-Z0-9_.:/+-]{1,100}$
keystoreId
string

Key store to mint the batch master key in. Defaults to your organization primary store.

Required string length: 1 - 64
Pattern: ^store-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"store-425nf-ebf0a-qq22t6qra51tj8j0"

Response

200 - application/json

Success

id
string
required

ID of the bulk wallet creation job.

Required string length: 1 - 64
Pattern: ^bwc-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"bwc-7jk0a-j19vv-4fhcj3452jceonu0"

status
enum<string>
required

Bulk wallet creation job status.

Available options:
Pending,
InProgress,
Completed,
PartiallyCompleted,
Failed
Last modified on September 3, 2026