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

Query parameters

chainIdstring[]

tokensstring[]

protocolsstring[]

tagsstring[]

isTestboolean

isPreTGEboolean

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 on-chain), in USD

Example

{
  "totalEarnedUSD": "string",
  "pendingUSD": "string",
  "claimableUSD": "string"
}

get

https://api.merkl.xyz/v4/users/{address}/rewards/stats

Merkl API

curl -X GET "https://api.merkl.xyz/v4/users/{address}/rewards/stats"

Fill the required path parameter address to send.