Skip to main content
GET
List activity
Deposit activity may appear with status: "processing" before finality for workflow-idle wallets. Processing deposit activity means Ground has detected the inbound onchain transfer; it is not yet credited to wallet balances.

Authorizations

Authorization
string
header
required

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

Query Parameters

walletId
string<uuid>[]

Optional repeatable wallet ID filter.

cursor
string

Opaque cursor from a prior response.

limit
integer
default:20

Maximum number of activity items to return. Runtime clamps invalid, missing, and oversized values into the supported 1-100 range.

Required range: 1 <= x <= 100
scope
enum<string>

Use all to include organization-wide activity. Omit for the default wallet-scoped view, optionally filtered by walletId.

Available options:
all
type
enum<string>

Filter activity by type.

Available options:
deposit,
withdrawal,
rebalance
status
string

Comma-separated public activity statuses to include, or all.

Example:

"created,processing"

startAt
string<date-time>

Inclusive ISO-8601 UTC lower bound for activity timestamps.

endAt
string<date-time>

Exclusive ISO-8601 UTC upper bound for activity timestamps.

Response

Activity feed

data
object[]

Canonical list envelope. Same items as activity (kept as a backwards-compatible alias).

activity
object[]

Backwards-compatible alias of data.

nextCursor
string | null
hasMore
boolean