---
title: "Recipient reward diff between two trees (BETA)"
method: GET
path: "/v4/historical/recipient/{recipient}"
tags: ["Historical"]
---

# Recipient reward diff between two trees (BETA)

`GET /v4/historical/recipient/{recipient}`

**Historical Recipient Diff**<p>Computes the difference in reward breakdowns for a given recipient between two merkle trees. Each tree is selected either by date (closest root on or before the date, via <code>startDate</code>/<code>endDate</code>) or by an explicit root hash (<code>startRoot</code>/<code>endRoot</code>). Returns per-campaign, per-reason breakdown diffs with non-zero changes only.</p><p><strong>Authentication:</strong> Requires a valid API key passed via the <code>Authorization</code> header.</p><p>⚠️ <strong>Beta:</strong> this endpoint is in beta. The behavior, response shape and data format may change at any time without notice. Historical data is only available from the configured cutoff date onwards.</p>

## Path parameters

- `recipient` string, required

## Query parameters

- `chainId` union, required
  - string, numeric
  - number
- `startDate` string — ISO date or unix timestamp. One of startDate or startRoot required.
- `endDate` string — ISO date or unix timestamp. One of endDate or endRoot required.
- `startRoot` string — Start merkle root hash. One of startDate or startRoot required.
- `endRoot` string — End merkle root hash. One of endDate or endRoot required.

## Response `200`

Response for status 200

- object
  - `startRoot` object, required
    - `root` string, required
    - `timestamp` string, required
  - `endRoot` object, required
    - `root` string, required
    - `timestamp` string, required
  - `breakdowns` object[], required
    - `campaignId` string, required
    - `recipient` string, required
    - `reason` string, required
    - `rewardToken` string, required
    - `startAmount` string, required — Cumulative reward amount at startDate
    - `endAmount` string, required — Cumulative reward amount at endDate
    - `diff` string, required — Difference between endAmount and startAmount

---

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