> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Tokenholder Distributions

> Daily capital returned to token holders by one project, as token buybacks and dividends in USD. Each series is one project, keyed by its project slug, or its parent protocol's short name when no project is mapped, and matching the protocol-revenue series key.

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), every series available in one call |

## Endpoints

> **[List Projects](https://docs.blockworks.com/api-reference/data-api/protocol-revenue/tabular-project-tokenholder-distributions.md)**
>
> One page of rows with per-column filters, sorting and pagination.

> **[Batch Get Project timeseries](https://docs.blockworks.com/api-reference/data-api/protocol-revenue/timeseries-project-tokenholder-distributions.md)**
>
> Every series in one request, or the named ones.

> **[Get Project timeseries](https://docs.blockworks.com/api-reference/data-api/protocol-revenue/timeseries-project-tokenholder-distributions-by-id.md)**
>
> 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

```bash curl theme={null}
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](https://docs.blockworks.com/api-reference/data-api/protocol-revenue/timeseries-project-tokenholder-distributions-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.