Get user wallet activity (deposits, withdrawals, transfers)

curl --request GET \
  --url https://api.gauntlet.xyz/v1/users/{wallet_address}/activity \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "assets_delta": {
        "native": "<string>",
        "token": {
          "address": "<string>",
          "symbol": "<string>"
        }
      },
      "block_hash": "<string>",
      "block_number": 123,
      "block_timestamp": 123,
      "shares_delta": "<string>",
      "tx_hash": "<string>",
      "type": "<string>",
      "vault_id": "<string>",
      "request_hash": "<string>"
    }
  ],
  "meta": {
    "count": 123,
    "limit": 123,
    "refreshed_at": "2023-11-07T05:31:56Z",
    "request_id": "<string>",
    "end": "2023-11-07T05:31:56Z",
    "next_cursor": "<string>",
    "start": "2023-11-07T05:31:56Z"
  }
}

Users

Get user wallet activity (deposits, withdrawals, transfers)

Immutable log of on-chain events that affected the wallet’s vault position. Each row is a frozen-in-time record; rows never mutate after emission.

?vault_id= narrows to one vault; omitted = activity across every vault the wallet has touched. Each row echoes its vault_id so wallet-wide consumers can distinguish per-vault activity.

Async deposit/redeem lifecycles emit multiple rows (one at request time with status=pending, a later one with status=settled or refunded). Consumers correlate them via request_hash to follow a single action across rows. Sync flows emit one row directly in the settled state.

Pagination is cursor-only. Default order is desc (newest first). Default page size 100, max 1000.

GET

users

{wallet_address}

activity

Get user wallet activity (deposits, withdrawals, transfers)

curl --request GET \
  --url https://api.gauntlet.xyz/v1/users/{wallet_address}/activity \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "assets_delta": {
        "native": "<string>",
        "token": {
          "address": "<string>",
          "symbol": "<string>"
        }
      },
      "block_hash": "<string>",
      "block_number": 123,
      "block_timestamp": 123,
      "shares_delta": "<string>",
      "tx_hash": "<string>",
      "type": "<string>",
      "vault_id": "<string>",
      "request_hash": "<string>"
    }
  ],
  "meta": {
    "count": 123,
    "limit": 123,
    "refreshed_at": "2023-11-07T05:31:56Z",
    "request_id": "<string>",
    "end": "2023-11-07T05:31:56Z",
    "next_cursor": "<string>",
    "start": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

wallet_address

string

required

Ethereum wallet address

Query Parameters

vault_id

string

CAIP-10 vault identifier. Optional — omit for wallet-wide activity across every vault the wallet has touched.

string

Opaque cursor from previous meta.next_cursor.

limit

integer<int64>

Page size (1–1000, default 100).

order

string

Sort direction: desc (default) or asc.

Response

User wallet activity

data

object[]

required

Show child attributes