Skip to main content
POST
Create a Wallet

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
requestId
string<uuid>
required

Client-generated idempotency key (UUID v4).

strategy
object
required
label
string | null

Optional human-readable label for the wallet.

Response

Wallet returned. New wallets may still be provisioning with status: creating.

id
string<uuid>
label
string | null
createdAt
string<date-time>
status
enum<string>

Compact wallet lifecycle and active-workflow status.

Available options:
creating,
idle,
withdrawal_active,
rebalance_active,
withdrawal_and_rebalance_active,
failed
failureReason
string | null
depositAddresses
object

Deposit addresses keyed by chain name.

Example:
balance
object
positions
object[]
strategyAllocations
object

Desired strategy targets grouped by stablecoin. Each returned group uses basis-point weights that sum to 10000.