> ## 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.

# Token Transparency Projects

> One row per project with at least one published Token Transparency Framework filing, keyed by project slug: name, ticker, the mapped project record and filing count. Lists which projects have filed and resolves a ticker to a project.

|               |                                                 |
| ------------- | ----------------------------------------------- |
| Access        | Token\_transparency\_framework\_unified         |
| Tabular model | `token-transparency-projects`: primary key `id` |

## Endpoints

<CardGroup cols={2}>
  <Card title="List Token Transparency Projects" icon="arrow-right" href="/api-reference/data-api/token-transparency-framework/tabular-token-transparency-projects">
    One page of rows with per-column filters, sorting and pagination.
  </Card>

  <Card title="Get Token Transparency Project" icon="arrow-right" href="/api-reference/data-api/token-transparency-framework/tabular-token-transparency-projects-by-id">
    One row by `id`.
  </Card>
</CardGroup>

## 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`, `IsNotOneOf` | yes     | The Blockworks research project slug, the public identity of the project. (primary key)           |
| `name`           | string | `Eq`, `IsOneOf`, `Contains`   | default | The display name of the project's protocol.                                                       |
| `slug`           | string | `Eq`, `IsOneOf`               | yes     | The project's slug elsewhere in the API, when the research project is mapped to a project record. |
| `protocolTicker` | string | `Eq`, `IsOneOf`, `IsNotOneOf` |         | The asset ticker of the project's protocol; null when the project has no asset.                   |
| `bwProjectID`    | int64  | `Eq`, `IsOneOf`               |         | The Blockworks research project id.                                                               |
| `projectID`      | string | `Eq`, `IsOneOf`               |         | The identifier of the mapped project record, when mapped.                                         |
| `projectName`    | string |                               |         | The name of the mapped project record, when mapped.                                               |
| `filingCount`    | int32  |                               | yes     | Number of published filings for the project.                                                      |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/tabular/token-transparency-projects?pageSize=3&selections=id,name,slug,protocolTicker" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [List Token Transparency Projects](/api-reference/data-api/token-transparency-framework/tabular-token-transparency-projects) for the response and the errors.