Reallocations

Retrieve Reallocation Breakdown

<p>Returns aggregated reallocation amounts grouped by recipient and campaign.</p> <p>Filters only successful reallocation operations (reason = "reallocation").</p> <p>Use query parameters to filter by chain, recipients, and campaigns.</p> <p><strong>Authentication:</strong> Requires either a valid <code>x-api-key</code> header or the back-office bearer secret.</p>
get/v4/reallocations/breakdown

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/reallocations/breakdown
  • Auth: apiKey (a scheme the document does not define)

Query parameters

string numeric required
OR
number required

Required. Distribution chain ID where reallocations occurred (numeric, e.g. 1 for Ethereum)

tostring[]

Filter by recipient address(es). Comma-separated or repeated query parameter supported. Returns reallocations TO these addresses.

campaignIdsstring[]

Filter by on-chain campaign ID(s) (32-byte hex hash, e.g. 0x93cf385c...). Comma-separated or repeated query parameter supported. NOT internal Campaign.id. See ID types.

Response

Response for status 200

chainIdnumber required

Distribution chain ID where the reallocation occurred

campaignIdstring required

On-chain campaign ID (32-byte hex hash, e.g. 0x93cf385c...). NOT internal Campaign.id. See ID types.

tostring required

Recipient address receiving the reallocated rewards

tokenAddressstring required

Address of the reward token

tokenSymbolstring

Human-readable symbol of the reward token (e.g. USDC, ANGLE)

tokenDecimalsnumber

Number of decimals for the reward token (e.g. 18 for ANGLE, 6 for USDC)

amountstring required

Total reallocated amount in raw token units (wei). String format to preserve precision for large BigInt values. Divide by 10^tokenDecimals for human-readable amount.

countnumber required

Number of individual reallocation entries (LeafBreakdown records with reason=reallocation) aggregated into this total

Changes

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