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",
      "depositAddresses": {
        "ethereum": "0xAbC1230000000000000000000000000000000001",
        "arbitrum": "0xAbC1230000000000000000000000000000000001",
        "base": "0xAbC1230000000000000000000000000000000001",
        "polygon": "0xAbC1230000000000000000000000000000000001",
        "solana": "7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1"
      },
      "balance": {
        "totalUsd": "100.00",
        "withdrawableUsd": "95.00",
        "earnedUsd": "5.00"
      },
      "positions": [
        {
          "yieldSourceId": "usdz",
          "name": "Anzen USDz",
          "valueUsd": "60.00",
          "earnedUsd": "3.00",
          "targetPct": 60
        },
        {
          "yieldSourceId": "resolv-lp",
          "name": "Resolv LP",
          "valueUsd": "35.00",
          "earnedUsd": "2.00",
          "targetPct": 40
        },
        {
          "type": "cash",
          "name": "Cash",
          "valueUsd": "5.00",
          "earnedUsd": "0.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.

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.