---
title: "GET /v4/volume/user"
method: GET
path: "/v4/volume/user"
tags: ["Volume"]
---

# GET /v4/volume/user

`GET /v4/volume/user`

Aggregated volume for a single user (recipient), filterable by program, clientId, chainId and a timestamp range (all optional, AND-combined). Returns the summed amountUSD and matching entry count.

## Query parameters

- `recipient` string, required — The user's wallet address (case-insensitive).
- `program` string — Filter by the config's program.
- `clientId` string — Filter by the config's clientId.
- `chainId` union — Filter by the config's chainId.
  - string, numeric
  - number — Filter by the config's chainId.
- `fromTimestamp` union — Only entries with timestamp >= this (unix seconds).
  - string, numeric
  - number — Only entries with timestamp >= this (unix seconds).
- `toTimestamp` union — Only entries with timestamp <= this (unix seconds).
  - string, numeric
  - number — Only entries with timestamp <= this (unix seconds).

## Response `200`

Response for status 200

- object
  - `recipient` string, required — The queried wallet address.
  - `volumeUSD` number, required — Sum of amountUSD across matching entries.
  - `entryCount` number, required — Number of matching entries.

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) · [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merkl/merkl-api/revisions/a7e5b9f6fb5f/schema)