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

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

`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

- `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

## Response `200`

Response for status 200

- object
  - `totalEarnedUSD` string, required — All-time earned (claimed + claimable + pending) in USD
  - `pendingUSD` string, required — Earned but not yet claimable (not in any merkle root), in USD
  - `claimableUSD` string, required — Currently claimable (in live root, not yet claimed on-chain), in USD

---

[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)