
get
/v4/leaves/{recipient}/breakdowns
Returns paginated leaf breakdowns for a recipient, token, and chain, including both distributed and pending amounts. Supports filters on campaignId, opportunityId, and protocolId.
Path parameters
recipientstringrequired
Recipient wallet address
Query parameters
tokenAddressstringrequired
Reward token address
distributionChainIdnumber | stringrequired
Distribution chain ID
campaignIdstringFilter by campaign ID (exact match)
opportunityIdstringFilter by opportunity ID (exact match)
protocolIdstring[]pagenumber | stringdefault: 00-indexed page number
itemsnumber | stringdefault: 20Number of items returned by page
Responses
200Response for status 200
Schema
object
breakdownsobject[]required
distributionChainIdnumber | stringtokenAddressstringcampaignIdstringHashed campaign IDreasonstringamountstringclaimedstringpendingstringCampaignanyFull Campaign object with Opportunity includecountnumber | stringrequired
Example
{
"breakdowns": [
{
"distributionChainId": 0,
"tokenAddress": "string",
"campaignId": "string",
"reason": "string",
"amount": "string",
"claimed": "string",
"pending": "string",
"Campaign": null
}
],
"count": 0
}get
https://api.merkl.xyz/v4/leaves//breakdowns?tokenAddress=&distributionChainId=&page=&items=curl -X GET "https://api.merkl.xyz/v4/leaves/0xd93814273b33DD33B32cD345225CfB65DEB048Dd/breakdowns?tokenAddress=0x3a4de44B29995a3D8Cd02d46243E1563E55bCc8b&distributionChainId=1&page=0&items=20"