Skip to main content
POST
/
v2
/
wallets
Create a Wallet
curl --request POST \
  --url https://sandbox.groundtech.co/v2/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "a1b2c3d4-0000-4000-8000-000000000001",
  "label": "Corporate Treasury",
  "strategy": {
    "allocations": [
      {
        "yieldSourceId": "cash",
        "pct": 20
      },
      {
        "yieldSourceId": "morpho-gauntlet-usdc",
        "pct": 50
      },
      {
        "yieldSourceId": "morpho-steakhouse-usdc",
        "pct": 30
      }
    ]
  }
}
'
{
  "id": "b1c2d3e4-0000-4000-8000-000000000001",
  "label": "Corporate Treasury",
  "createdAt": "2025-09-01T00:00:00Z",
  "status": "creating",
  "failureReason": null,
  "depositAddresses": {},
  "balance": {
    "totalUsd": "0.000000",
    "withdrawableUsd": "0.000000",
    "reservedUsd": "0.000000",
    "earnedUsd": "0.000000"
  },
  "positions": []
}

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.

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