Skip to main content
GET
/
v2
/
activity
List activity
curl --request GET \
  --url https://sandbox.groundtech.co/v2/activity \
  --header 'Authorization: Bearer <token>'
{
  "activity": [
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000001",
      "type": "deposit",
      "status": "completed",
      "amountUsd": "5000.000000",
      "timestamp": "2025-09-05T10:00:00Z",
      "deposit": {
        "id": "a1b2c3d4-0000-4000-8000-000000000001",
        "amount": "5000.000000",
        "token": "usdc",
        "chain": "ethereum",
        "fromAddress": "0xfeed00000000000000000000000000000000beef",
        "txHash": "0xb4ec6ad9f2f2d75fb8df30c6e49b1f319138f0172d7bff7c402e7dcb7f017e8a",
        "status": "completed",
        "createdAt": "2025-09-05T10:00:00Z",
        "completedAt": "2025-09-05T10:01:15Z"
      }
    },
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000002",
      "type": "withdrawal",
      "status": "processing",
      "amountUsd": "65000.000000",
      "timestamp": "2025-09-05T11:00:00Z",
      "withdrawal": {
        "id": "a1b2c3d4-0000-4000-8000-000000000002",
        "amountRequestedUsd": "65000.000000",
        "amountPaidUsd": null,
        "feeUsd": "0.000000",
        "destinationChain": "ethereum",
        "destinationAddress": "0x76F8fc6667E239f83a547d4e16225d6a34f6FA22",
        "destinationToken": "usdc",
        "status": "processing",
        "legsCompleted": 0,
        "legsTotal": 1,
        "payoutLegs": [
          {
            "status": "pending_customer_approval",
            "amountUsd": "65000.000000",
            "from": {
              "kind": "yield_source",
              "id": "syrup-usdc",
              "label": "Syrup USDC"
            },
            "to": {
              "kind": "external_payout",
              "id": "external_payout:ethereum:usdc",
              "label": "External payout (Ethereum)"
            },
            "startedAt": "2025-09-05T11:00:00Z",
            "completedAt": null,
            "stepsCompleted": 1,
            "stepsTotal": 2,
            "steps": [
              {
                "name": "Redeeming from Syrup USDC",
                "stepKind": "yield_source_redeem",
                "sequenceRole": "yield_redeem",
                "protocolType": "syrup",
                "stepOrdinal": 0,
                "chain": "ethereum",
                "txKind": "yield_source_redeem",
                "state": "completed",
                "startedAt": "2025-09-05T11:00:00Z",
                "completedAt": "2025-09-05T11:01:00Z",
                "cancelledAt": null
              },
              {
                "name": "Sending payout",
                "stepKind": "external_payout_transfer",
                "sequenceRole": "external_payout_transfer",
                "protocolType": "external_payout",
                "stepOrdinal": 1,
                "chain": "ethereum",
                "txKind": "external_payout_transfer",
                "state": "pending_customer_approval",
                "startedAt": "2025-09-05T11:01:00Z",
                "completedAt": null,
                "cancelledAt": null
              }
            ]
          }
        ],
        "failureReason": null,
        "createdAt": "2025-09-05T11:00:00Z",
        "completedAt": null
      }
    }
  ],
  "nextCursor": null,
  "hasMore": false
}
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

​
activity
object[]
​
nextCursor
string | null
​
hasMore
boolean