Skip to main content
PATCH

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

Wallet ID

Body

application/json
label
string | null
required

Human-readable wallet label. Send null or an empty string to clear the label.

Response

Wallet updated

autoRebalance
boolean
required

Whether Ground automatically deploys deposits and maintains the wallet's percentage targets.

strategyAllocations
object | null
required

Percentage targets when automatic rebalancing is enabled. Always null when it is disabled.

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. Sandbox wallets use ethereum_sepolia and solana_devnet; production wallets use arbitrum, base, ethereum, polygon, and solana.

Example:
balance
object
positions
object[]