List Token Transparency Reports

GET

transparency

curl --request GET \
  --url https://api.blockworks.com/v1/transparency \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.blockworks.com/v1/transparency"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.blockworks.com/v1/transparency', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": 1,
      "asset_id": 345426,
      "summary": "",
      "created_at": 1755624545,
      "updated_at": 1758051174,
      "project_team": {
        "rating": 10,
        "max": 10
      },
      "token_allocation": {
        "rating": 17,
        "max": 18
      },
      "market_structure": {
        "rating": 7,
        "max": 7
      },
      "financial_disclosure": {
        "rating": 4,
        "max": 5
      }
    }
  ],
  "total": 27,
  "page": 1
}

Overview

This endpoint returns a paginated list of token transparency framework reports, with scores across four key categories: Project & Team, Token Allocation, Market Structure, and Financial Disclosure. This powers the Token Transparency page on the Blockworks website.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/transparency?limit=20"

const response = await fetch(
  'https://api.blockworks.com/v1/transparency?limit=20',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
)
const data = await response.json()

import requests

response = requests.get(
    'https://api.blockworks.com/v1/transparency',
    headers={'x-api-key': 'YOUR_API_KEY'},
    params={'limit': 20}
)
data = response.json()

Example Response

A successful response returns a paginated list of transparency reports.

{
  "data": [
    {
      "id": 1,
      "asset_id": 345426,
      "summary": "",
      "created_at": 1755624545,
      "updated_at": 1758051174,
      "project_team": {
        "rating": 10,
        "max": 10
      },
      "token_allocation": {
        "rating": 17,
        "max": 18
      },
      "market_structure": {
        "rating": 7,
        "max": 7
      },
      "financial_disclosure": {
        "rating": 4,
        "max": 5
      }
    },
    {
      "id": 2,
      "asset_id": 345837,
      "summary": null,
      "created_at": 1755624584,
      "updated_at": 1755624584,
      "project_team": {
        "rating": 10,
        "max": 10
      },
      "token_allocation": {
        "rating": 18,
        "max": 18
      },
      "market_structure": {
        "rating": 7,
        "max": 7
      },
      "financial_disclosure": {
        "rating": 4,
        "max": 5
      }
    }
  ],
  "total": 27,
  "page": 1
}

Supported Options

Name	Type	Details	Available Options
`expand`	query	Expand related data.	`asset`
`limit`	query	The number of reports to return (max: 100, default: 100)	`1-100`
`page`	query	The page number to return.	any numeric value
`order_by`	query	Field to order results by.	`asset.title`, `project_team`, `token_allocation`, `market_structure`, `financial_disclosure`, `total`
`order_dir`	query	Order direction for results. Default is `asc` (ascending).	`asc`, `desc`

Response Fields

Field	Type	Description
`id`	number	Unique report identifier
`asset_id`	number	Associated asset identifier
`summary`	string	Report summary text
`created_at`	number	Unix timestamp when report was created
`updated_at`	number	Unix timestamp of last update
`project_team`	object	Project & Team category scores
`project_team.rating`	number	Score achieved in this category
`project_team.max`	number	Maximum possible score
`token_allocation`	object	Token Allocation category scores
`token_allocation.rating`	number	Score achieved in this category
`token_allocation.max`	number	Maximum possible score
`market_structure`	object	Market Structure category scores
`market_structure.rating`	number	Score achieved in this category
`market_structure.max`	number	Maximum possible score
`financial_disclosure`	object	Financial Disclosure category scores
`financial_disclosure.rating`	number	Score achieved in this category
`financial_disclosure.max`	number	Maximum possible score

Authorizations

x-api-key

string

header

required

Query Parameters

page

integer

default:1

Required range: 1 <= x <= 2147483647

limit

integer

default:100

Required range: 1 <= x <= 100

expand

enum<string>[]

Available options:

asset

query

string<json>

Maximum string length: 65535

order_by

string

default:id

order_dir

enum<string>

default:asc

Available options:

asc,

desc

Response

Get Chart Data Market Stats

⌘I

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

List Token Transparency Reports

Overview

Example Request

Example Response

Supported Options

Response Fields

Authorizations

Query Parameters

Response

​Overview

​Example Request

​Example Response

​Supported Options

​Response Fields

​Related Endpoints

Authorizations

Query Parameters

Response

Overview

Example Request

Example Response

Supported Options

Response Fields

Related Endpoints