Skip to main content
POST
Atomic: create N fresh wallets and a wallet group containing them in a single transaction. Used by the treasury-agent surface and the terminal's "Generate new wallets" pathway.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <jwt> for user auth or Authorization: Bearer sk_{keyId}_{secret} for API key auth.

Body

application/json

Request body for POST /api/v2/wallet-groups/with-wallets.

Atomically creates a fresh wallet group plus N freshly-generated wallets on chain, in a single Prisma transaction. Wallets are auto-named <name> 1..N server-side.

chain
string
required

Chain. svm | base | bsc.

name
string
required

Group name (1-32 chars). Wallets are auto-named <name> 1..N.

walletCount
integer<int32>
required

Number of fresh wallets. 1..=16.

Required range: 1 <= x <= 16

Response

V2 success response envelope

data
object
required
requestId
string
required
pagination
object | null

Page-based pagination info (per RFC)