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",
        "solana": "7vFg...abc1"
      },
      "balance": {
        "totalUsd": "100.00",
        "withdrawableUsd": "95.00",
        "earnedUsd": "5.00",
        "pendingDepositsUsd": "0.00"
      },
      "strategy": {
        "allocations": [
          {
            "yieldSourceId": "syrup-usdc",
            "pct": 50
          },
          {
            "yieldSourceId": "aave-usdc",
            "pct": 50
          }
        ],
        "status": "active"
      },
      "positions": [
        {
          "yieldSourceId": "syrup-usdc",
          "valueUsd": "50.00",
          "apyBps": 850
        },
        {
          "yieldSourceId": "aave-usdc",
          "valueUsd": "50.00",
          "apyBps": 420
        }
      ]
    }
  ],
  "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.