Merkl Developer Portal logo
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

recipientstring
required

The user's wallet address (case-insensitive).

programstring

Filter by the config's program.

clientIdstring

Filter by the config's clientId.

chainIdnumber | string

Filter by the config's chainId.

fromTimestampnumber | string

Only entries with timestamp >= this (unix seconds).

toTimestampnumber | string

Only entries with timestamp <= this (unix seconds).

Responses

200
Response for status 200
Schema
object
recipientstring
required
The queried wallet address.
volumeUSDnumber
required
Sum of amountUSD across matching entries.
entryCountnumber
required
Number of matching entries.
Example
{
  "recipient": "string",
  "volumeUSD": 0,
  "entryCount": 0
}