Merkl Developer Portal logo
get

/v4/creators/{creator}/distributed/over-time

Token distribution over time for a creator, bucketed and broken down per reward token (token amounts, not USD)

Path parameters

creatorstring
required

Query parameters

rangeenum

Rolling window of data to include: last 7 days, last 30 days, or the full history.

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 reward-token series across all buckets (chart legend), descending by total USD value
idstringToken id — matches `breakdown.tokenId` entries
symbolstringToken symbol displayed in the chart legend
chainIdnumberChain ID of the token
addressstringToken address
decimalsnumberToken decimals
iconstringToken icon URL
pricenumber | nullCurrent USD price, for optional client-side USD display
bucketsobject[]
required
Distribution buckets, ascending by start timestamp; buckets with no data are omitted
startnumberUnix timestamp (seconds) of the bucket start, UTC-aligned
endnumberUnix timestamp (seconds) of the bucket end (exclusive)
breakdownobject[]Per-token amount, descending by USD value
tokenIdstringToken id matching an entry in `tokens`
amountnumberToken units distributed in the bucket
Example
{
  "bucket": "day",
  "range": "7d",
  "tokens": [
    {
      "id": "string",
      "symbol": "string",
      "chainId": 0,
      "address": "string",
      "decimals": 0,
      "icon": "string",
      "price": 0
    }
  ],
  "buckets": [
    {
      "start": 0,
      "end": 0,
      "breakdown": [
        {
          "tokenId": "string",
          "amount": 0
        }
      ]
    }
  ]
}