GET /v4/users/:address/rewards/stats — merkl-api

Authentication7

Block Timestamp3

Campaign Lists6

Campaign Privacy3

Campaigns9

Chains2

Claims5

Config19

Creator9

Credits9

Developer API Keys7

Enums4

GraphQL8

Health8

Historical3

Key Value Store9

Leaves2

Node6

OffchainBilling3

Opportunities14

Overrides2

Programs3

Protocols3

Reallocations1

Referral2

Rewards12

Roots2

Schemas3

SOFR Spread Ratchet2

Templates3

Tokens5

Users11

Volume4

Users

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

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

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

Response

Response for status 200

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

Changes

No recorded changes to this endpoint across all 2 revisions of this API.