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

rootstring

campaignIdstring

recipientstring

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"
    }
  ]
}

get

https://api.merkl.xyz/v4/historical/tree

Merkl API

curl -X GET "https://api.merkl.xyz/v4/historical/tree"