---
title: "GET /v4/creators/{creator}/distributed/over-time"
method: GET
path: "/v4/creators/{creator}/distributed/over-time"
tags: ["Creator"]
---

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

`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

- `creator` string, required

## Query parameters

- `range` union — Rolling window of data to include: last 7 days, last 30 days, or the full history.
  - string
  - string
  - string

## Response `200`

Response for status 200

- object
  - `bucket` union, required — Granularity of each bucket (UTC-aligned).
    - string
    - string
    - string
  - `range` union, required — Rolling window of data to include: last 7 days, last 30 days, or the full history.
    - string
    - string
    - string
  - `tokens` object[], required — Distinct reward-token series across all buckets (chart legend), descending by total USD value
    - `id` string, required — Token id — matches `breakdown.tokenId` entries
    - `symbol` string, required — Token symbol displayed in the chart legend
    - `chainId` number, required — Chain ID of the token
    - `address` string, required — Token address
    - `decimals` number, required — Token decimals
    - `icon` string, required — Token icon URL
    - `price` number, required — Current USD price, for optional client-side USD display
  - `buckets` object[], required — Distribution buckets, ascending by start timestamp; buckets with no data are omitted
    - `start` number, required — Unix timestamp (seconds) of the bucket start, UTC-aligned
    - `end` number, required — Unix timestamp (seconds) of the bucket end (exclusive)
    - `breakdown` object[], required — Per-token amount, descending by USD value
      - `tokenId` string, required — Token id matching an entry in `tokens`
      - `amount` number, required — Token units distributed in the bucket

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) · [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merkl/merkl-api/revisions/b7784c9a78b9/schema)