get

/v4/claims/earnings/{address}

Aggregate a recipient's claimed rewards into time buckets broken down by token, in USD. Supports bucket granularity (day/week/month, default week) and range window (7d/30d/all, default all).

Path parameters

addressstring
required

Query parameters

chainIdsnumber | string[]
bucketenum
dayweekmonth
rangeenum
7d30dall

Responses

200
Response for status 200
Schema
object
bucketenum
required
Granularity of each bucket (UTC-aligned).dayweekmonth
rangeenum
required
Rolling window of data to include: last 7 days, last 30 days, or the full history.7d30dall
tokensobject[]
required
Distinct token series across all buckets (chart legend)
idstringStable chart series id (`chainId:tokenAddress`, or `__other__` for folded tokens)
symbolstringToken symbol displayed in the chart legend
chainIdnumberChain ID of the token; absent for synthetic series like `Other`
addressstringToken address; absent for synthetic series like `Other`
iconstringToken icon URL; absent for synthetic series like `Other`
pricenumberCurrent token price in USD; absent when unpriced or for synthetic series
bucketsobject[]
required
Earnings buckets, ascending by start timestamp
startnumberUnix timestamp (seconds) of the bucket start, UTC-aligned
endnumberUnix timestamp (seconds) of the bucket end (exclusive)
breakdownobject[]Per-token USD value, descending
tokenIdstringStable token series id matching an entry in `tokens`
valuenumberUSD value earned in the bucket
Example
{
  "bucket": "day",
  "range": "7d",
  "tokens": [
    {
      "id": "string",
      "symbol": "string",
      "chainId": 0,
      "address": "string",
      "icon": "string",
      "price": 0
    }
  ],
  "buckets": [
    {
      "start": 0,
      "end": 0,
      "breakdown": [
        {
          "tokenId": "string",
          "value": 0
        }
      ]
    }
  ]
}
get
https://api.merkl.xyz/v4/claims/earnings/{address}
Merkl API
curl -X GET "https://api.merkl.xyz/v4/claims/earnings/{address}"
Fill the required path parameter address to send.