Skip to main content
GET
/
v2
/
wallets
/
{id}
/
deposits
List wallet deposits
curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets/{id}/deposits \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "d1e2f3a4-0000-4000-8000-000000000001",
      "amount": "100.50",
      "token": "usdc",
      "chain": "ethereum",
      "fromAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "txHash": "0xb4ec6ad9f2f2d75fb8df30c6e49b1f319138f0172d7bff7c402e7dcb7f017e8a",
      "status": "completed",
      "createdAt": "2025-09-02T12:00:00Z",
      "completedAt": "2025-09-02T12:05:00Z"
    },
    {
      "id": "d1e2f3a4-0000-4000-8000-000000000002",
      "amount": "25.00",
      "token": "usdc",
      "chain": "base",
      "fromAddress": "0xfeed00000000000000000000000000000000beef",
      "txHash": "0x9d0a6ad9f2f2d75fb8df30c6e49b1f319138f0172d7bff7c402e7dcb7f017e8b",
      "status": "processing",
      "createdAt": "2025-09-02T12:06:00Z",
      "completedAt": null
    }
  ],
  "nextCursor": null
}
Deposits can appear with status: "processing" as soon as Ground detects a likely USDC transfer into a workflow-idle wallet. A processing deposit is not final, not included in balances, and has completedAt: null. After finality and ledger posting, the same onchain deposit is returned as a completed deposit with the same deposit id and completedAt populated. Wallets with active Ground-managed workflows may wait until final attribution before showing a deposit.

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

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:50

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

Required range: 1 <= x <= 200
​
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 deposits created at or after this ISO-8601 timestamp.

Response

Cursor-paginated list of deposits

​
data
object[]
​
nextCursor
string | null

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