Merkl Developer Portal logo
get

/v4/users/{address}/rewards/breakdowns

Per-chain rewards with full opportunity breakdowns and proofs. Returns the same shape as /v4/users/{address}/rewards but with the breakdowns included. Limited to roughly 1000 breakdowns per response; responses exceeding this limit omit the breakdowns. For high-volume users, paginate via /v4/leaves/{recipient}/breakdowns instead.

Path parameters

addressstring
required

User address

Query parameters

tagsstring

Only get reward breakdowns for opportunities with this tag

chainIdsstring[]

Filter by chain IDs

reloadChainIdnumber | string

Chain ID to bypass cache and check for recent claims

testboolean

Include test token rewards

claimableOnlyboolean

Include only claimable rewards (to avoid transferring zero amounts)

showPrivateboolean

When true, decode private campaign IDs instead of returning the zero hash. Requires the caller's identity (JWT or API key owner) to match the queried address — otherwise returns 403. Also bypasses CDN cache.