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

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 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
        }
      ]
    }
  ]
}

get

https://api.merkl.xyz/v4/creators/{creator}/distributed/over-time

Merkl API

curl -X GET "https://api.merkl.xyz/v4/creators/{creator}/distributed/over-time"

Fill the required path parameter creator to send.