Merkl Developer Portal logo
get

/v4/users/{address}/rewards/stats

Lightweight USD totals for a user — total earned, currently claimable, and pending. Supports optional filters: chainId, chains, tokens, protocols, isTest, isPreTGE.

Path parameters

addressstring
required

User address

Query parameters

chainIdstring[]

Filter by chain IDs

tokensstring[]

Filter by reward token addresses

protocolsstring[]

Filter by main protocol IDs

tagsstring[]

Filter by opportunity tags (whitelabel scoping)

isTestboolean

Include test token rewards

isPreTGEboolean

When true, restrict to preTGE (PRETGE) token rewards

Responses

200
Response for status 200
Schema
object
totalEarnedUSDstring
required
All-time earned (claimed + claimable + pending) in USD
pendingUSDstring
required
Earned but not yet claimable (not in any merkle root), in USD
claimableUSDstring
required
Currently claimable (in live root, not yet claimed onchain), in USD
Example
{
  "totalEarnedUSD": "string",
  "pendingUSD": "string",
  "claimableUSD": "string"
}