Merkl Developer Portal logo
get

/v4/historical/tree

Reward breakdowns of a single tree (BETA)

Historical Tree Breakdowns

Returns the cumulative reward breakdowns of a single merkle tree, selected either by date (closest root on or before the date) or by an explicit root hash. Results can be filtered by campaignId and/or recipient.

Authentication: Requires a valid API key passed via the Authorization header.

⚠️ Beta: 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.

Query parameters

chainIdnumber | string
required
datestring

ISO date or unix timestamp. One of date or root is required.

rootstring

Merkle root hash. One of date or root is required.

campaignIdstring

Optional campaign filter

recipientstring

Optional recipient filter

Responses

200
Response for status 200
Schema
object
rootstring
required
timestampstring
required
breakdownsobject[]
required
campaignIdstring
recipientstring
reasonstring
rewardTokenstring
amountstringCumulative reward amount in the tree
Example
{
  "root": "string",
  "timestamp": "string",
  "breakdowns": [
    {
      "campaignId": "string",
      "recipient": "string",
      "reason": "string",
      "rewardToken": "string",
      "amount": "string"
    }
  ]
}