Volume

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.

get/v4/volume/user

Request

  • Base URL: https://api.merkl.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.merkl.xyz/v4/volume/user
  • Auth: apiKey (a scheme the document does not define)

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.

string numeric
OR
number

Filter by the config's chainId.

string numeric
OR
number

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

string numeric
OR
number

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

Response

Response for status 200

recipientstring required

The queried wallet address.

volumeUSDnumber required

Sum of amountUSD across matching entries.

entryCountnumber required

Number of matching entries.

Changes

No recorded changes to this operation across all 36 revisions of this API.