Sign in
Users

Per-chain rewards rollup with USD totals and per-token raw amounts. A lightweight alternative to /rewards that omits full campaign breakdowns. Supports optional filters: chainId, chains, tokens, protocols, isTest, isPreTGE.

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

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

string numeric
OR
number

Chain ID to bypass cache and check for recent claims

Response

Response for status 200

amountUSDstring required

Sum of reward amounts on this chain in USD (live tree — includes claimed). Point tokens are excluded from this total; read rewards for point balances.

claimedUSDstring required

Sum of claimed amounts on this chain in USD. Point tokens are excluded.

pendingUSDstring required

Sum of pending amounts on this chain in USD (not yet in any merkle root). Point tokens are excluded.

Changes

No recorded changes to this endpoint across all 1 revision of this API.