Historical

Reward breakdowns of a single tree (BETA)

Historical Tree Breakdowns<p>Returns the cumulative reward breakdowns of a single merkle tree, selected either by <code>date</code> (closest root on or before the date) or by an explicit <code>root</code> hash. Results can be filtered by <code>campaignId</code> and/or <code>recipient</code>.</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>

get/v4/historical/tree

Request

  • Base URL: https://api.merkl.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.merkl.xyz/v4/historical/tree
  • Auth: apiKey (a scheme the document does not define)

Query parameters

string numeric required
OR
number 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

Response

Response for status 200

rootstring required
timestampstring required

Changes

No recorded changes to this operation across all 36 revisions of this API.