Skip to main content
PATCH
/
v2
/
wallets
/
{id}
curl --request PATCH \ --url https://sandbox.groundtech.co/v2/wallets/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "label": "Operating Treasury" } '
{
  "id": "b1c2d3e4-0000-4000-8000-000000000001",
  "label": "Operating Treasury",
  "createdAt": "2025-09-01T00:00:00Z",
  "depositAddresses": {
    "arbitrum": "0xAbC1230000000000000000000000000000000001",
    "base": "0xAbC1230000000000000000000000000000000001",
    "ethereum": "0xAbC1230000000000000000000000000000000001",
    "polygon": "0xAbC1230000000000000000000000000000000001",
    "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1"
  },
  "balance": {
    "totalUsd": "100.000000",
    "withdrawableUsd": "100.000000",
    "reservedUsd": "0.000000",
    "earnedUsd": "5.000000"
  },
  "positions": [
    {
      "id": "syrup-usdc",
      "kind": "yield_source",
      "label": "Syrup USDC",
      "valueUsd": "40.000000",
      "pct": 40
    },
    {
      "id": "morpho-gauntlet-usdc",
      "kind": "yield_source",
      "label": "Morpho Gauntlet USDC Prime",
      "valueUsd": "30.000000",
      "pct": 30
    },
    {
      "id": "morpho-steakhouse-usdc",
      "kind": "yield_source",
      "label": "Morpho Steakhouse USDC Prime",
      "valueUsd": "30.000000",
      "pct": 30
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt

Use this file to discover all available pages before exploring further.

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

​
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:
{
  "arbitrum": "0xAbC1230000000000000000000000000000000001",
  "base": "0xAbC1230000000000000000000000000000000001",
  "ethereum": "0xAbC1230000000000000000000000000000000001",
  "polygon": "0xAbC1230000000000000000000000000000000001",
  "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1"
}
​
balance
object
​
positions
object[]