---
title: "GET /v4/users/{address}/rewards/summary"
method: GET
path: "/v4/users/{address}/rewards/summary"
tags: ["Users"]
---

# GET /v4/users/{address}/rewards/summary

`GET /v4/users/{address}/rewards/summary`

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.

## Path parameters

- `address` string, required — User address

## Query parameters

- `chainId` string[] — Filter by chain IDs
- `tokens` string[] — Filter by reward token addresses
- `protocols` string[] — Filter by main protocol IDs
- `tags` string[] — Filter by opportunity tags (whitelabel scoping)
- `isTest` boolean — Include test token rewards
- `isPreTGE` boolean — When true, restrict to preTGE (PRETGE) token rewards
- `reloadChainId` union — Chain ID to bypass cache and check for recent claims
  - string, numeric
  - number — Chain ID to bypass cache and check for recent claims

## Response `200`

Response for status 200

- object[]
  - `chain` object, required — Chain
    - `id` integer, required — Chain Id
    - `name` string, required — Legible name of the chain
    - `icon` string, required — URL to the icon of the chain
    - `liveCampaigns` number, required — Number of campaigns currently live on this chain
    - `endOfDisputePeriod` number, required
    - `explorers` object[]
      - `type` union, required
        - string
        - string
        - string
      - `url` string, required
      - `chainId` number, required
    - `lastClaimsOnchainFetchTimestamp` string, required — Timestamp of the last claims onchain fetch
  - `amountUSD` string, 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.
  - `claimedUSD` string, required — Sum of claimed amounts on this chain in USD. Point tokens are excluded.
  - `pendingUSD` string, required — Sum of pending amounts on this chain in USD (not yet in any merkle root). Point tokens are excluded.
  - `rewards` object[], required
    - `token` object, required — Token
      - `id` string, required — Unique identifier for the token
      - `name` string, required — Full name of the token
      - `chainId` integer, required — Chain Id
      - `address` string, required — Address
      - `decimals` number, required — Number of decimals for the token
      - `symbol` string, required — Symbol of the token
      - `icon` string, required — URL to the token icon image
      - `verified` boolean, required — Whether the token is verified
      - `isNative` boolean, required — Whether this is a native blockchain token
      - `isTest` boolean, required — Whether this is a test token
      - `type` union, required — Type of the token (TOKEN, PRETGE, POINT)
        - string
        - string
        - string
      - `price` number — Current price of the token in USD
      - `updatedAt` number — Unix timestamp of last price update
      - `priceSource` string — Source of the price information
      - `displaySymbol` string — Custom display symbol override
      - `underlyingTokenId` string — If this token is a wrapper, the ID of the underlying token
      - `priceAlertDismissedAt` number
      - `priceAlertCount` number
    - `amount` string, required — Total reward amount in token wei (live tree)
    - `claimed` string, required — Amount already claimed in token wei
    - `pending` string, required — Amount pending in token wei (not yet in merkle root)
    - `proofs` string[], required — Merkle proofs required to claim this token reward on-chain

## Changes

- **2026-09-02** `b7784c9a78b9` — 1 info
  - the `items/rewards/items/token/address` response's property pattern was changed from `^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44}|[CG][A-Z0-9]{55})$` to `^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44}|[CG][A-Z0-9]{55}|0x[a-fA-F0-9]{64})$` for the status `200`

[Change history](https://skmtc.dev/merkl/apis/merkl-api/changes/v4/users/:address/rewards/summary/get.md)

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) · [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merkl/merkl-api/revisions/3af328974da5/schema)