Skip to main content
GET
/
v1
/
transparency
List Token Transparency Reports
curl --request GET \
  --url https://api.blockworks.com/v1/transparency \
  --header 'x-api-key: <api-key>'
{
  "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"

​
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

NameTypeDetailsAvailable Options
expandqueryExpand related data.asset
limitqueryThe number of reports to return (max: 100, default: 100)1-100
pagequeryThe page number to return.any numeric value
order_byqueryField to order results by.asset.title, project_team, token_allocation, market_structure, financial_disclosure, total
order_dirqueryOrder direction for results. Default is asc (ascending).asc, desc

​
Response Fields

FieldTypeDescription
idnumberUnique report identifier
asset_idnumberAssociated asset identifier
summarystringReport summary text
created_atnumberUnix timestamp when report was created
updated_atnumberUnix timestamp of last update
project_teamobjectProject & Team category scores
project_team.ratingnumberScore achieved in this category
project_team.maxnumberMaximum possible score
token_allocationobjectToken Allocation category scores
token_allocation.ratingnumberScore achieved in this category
token_allocation.maxnumberMaximum possible score
market_structureobjectMarket Structure category scores
market_structure.ratingnumberScore achieved in this category
market_structure.maxnumberMaximum possible score
financial_disclosureobjectFinancial Disclosure category scores
financial_disclosure.ratingnumberScore achieved in this category
financial_disclosure.maxnumberMaximum 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