Skip to main content
GET
List wallet deposits
Deposits can appear with status: "processing" as soon as Ground detects a likely supported-token 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.