Project Tokenholder Distributions

One row per project that returns capital to its token holders, keyed by its project slug (or its parent protocol’s short name when no project is mapped): name, slug, parent slug and project id. The id is the series key of the project-tokenholder-distributions timeseries model.


Access	Protocol-revenue-dataset
Tabular model	`project-tokenholder-distributions`: primary key `id`
Timeseries model	`project-tokenholder-distributions`: intervals `1d`, series key `id` (Project Tokenholder Distribution ID), series must be named (up to 10 per call)

Endpoints

List Projects

One page of rows with per-column filters, sorting and pagination.

Batch Get Project timeseries

Up to 10 series in one request, named by Project Tokenholder Distribution ID in series.

Get Project timeseries

One series over a time window, keyed by its Project Tokenholder Distribution ID.

Metrics

2 metrics. Use the Field value in selections; every point starts with the timestamp and continues in this order.

Field	Name	Type	Unit	Description
`buybacksUSD`	Buybacks (USD)	float64		Token buybacks in USD.
`dividendsUSD`	Dividends (USD)	float64		Dividends paid to token holders in USD.

Columns

Use the Field value in selections, sortBy, and as the base of a filter parameter (Field plus one of its Filters suffixes).

Field	Type	Filters	Sort	Description
`id`	string	`Eq`, `IsOneOf`		The series key of the project-tokenholder-distributions timeseries model, the project slug, or the parent protocol’s short name when no project is mapped. (primary key)
`name`	string	`Eq`, `IsOneOf`, `Contains`	default	The project’s name.
`slug`	string	`Eq`, `IsOneOf`	yes	The project’s slug, the slug used for the same project across the API.
`parentSlug`	string	`Eq`, `IsOneOf`	yes	The parent protocol’s short name (aave, morpho).
`projectID`	string	`Eq`, `IsOneOf`		The identifier of the project record; null when unmapped.

Example

curl

curl "https://api.blockworks.com/query/timeseries/project-tokenholder-distributions/1d/<id>?timeframe=7d&selections=buybacksUSD,dividendsUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"

See Get Project timeseries for the response and the errors.

Getting Started

Discovery

Concepts

Market Data

Onchain Fundamentals

Institutional

Fundraising

Social & Mindshare

News

Research

Token Unlocks

Token Transparency Framework

Charts