Skip to main content
GET
/
v2
/
wallets
List Wallets
curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "b1c2d3e4-0000-4000-8000-000000000001",
      "label": "Corporate Treasury",
      "createdAt": "2025-09-01T00:00:00Z",
      "status": "withdrawal_active",
      "failureReason": null,
      "depositAddresses": {
        "arbitrum": "0xAbC1230000000000000000000000000000000001",
        "base": "0xAbC1230000000000000000000000000000000001",
        "ethereum": "0xAbC1230000000000000000000000000000000001",
        "polygon": "0xAbC1230000000000000000000000000000000001",
        "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1"
      },
      "balance": {
        "totalUsd": "100.000000",
        "withdrawableUsd": "95.000000",
        "reservedUsd": "5.000000",
        "earnedUsd": "5.000000"
      },
      "positions": [
        {
          "id": "syrup-usdc",
          "kind": "yield_source",
          "label": "Syrup USDC",
          "valueUsd": "38.000000",
          "pct": 40
        },
        {
          "id": "morpho-gauntlet-usdc",
          "kind": "yield_source",
          "label": "Morpho Gauntlet USDC Prime",
          "valueUsd": "28.500000",
          "pct": 30
        },
        {
          "id": "morpho-steakhouse-usdc",
          "kind": "yield_source",
          "label": "Morpho Steakhouse USDC Prime",
          "valueUsd": "28.500000",
          "pct": 30
        },
        {
          "id": "cash:ethereum:usdc",
          "kind": "cash",
          "label": "Cash (Ethereum)",
          "valueUsd": "5.000000"
        }
      ]
    }
  ],
  "nextCursor": null
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
cursor
string

Opaque cursor from a prior response; pass it unchanged to fetch the next page (must be reused with the same filters and sort).

​
limit
integer
default:25

Maximum number of wallets to return in this response (smaller values reduce payload size and latency).

Required range: 1 <= x <= 100
​
sort
enum<string>
default:createdAt

Field to sort by (currently only createdAt is supported).

Available options:
createdAt
​
order
enum<string>
default:desc

Sort direction for results; use desc for newest-first or asc for oldest-first.

Available options:
asc,
desc
​
createdAtGte
string<date-time>

Filter results to wallets created at or after this ISO-8601 timestamp.

​
id
string<uuid>

Filter to a specific wallet ID.

​
requestId
string<uuid>

Filter to the wallet created with this idempotency request ID.

​
label
string

Filter to wallets whose label exactly matches this value.

​
search
string

Case-insensitive label search.

​
status
enum<string>

Filter by wallet lifecycle status stored on the wallet record. This is not the projected public response status, which can include active workflow states such as withdrawal_active or rebalance_active.

Available options:
creating,
active,
disabled,
failed

Response

Cursor-paginated list of wallets

​
data
object[]
​
nextCursor
string | null

Opaque cursor to fetch the next page, or null when there are no more results.