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

​
Overview

Fetch a single token transparency report by ID. You can optionally expand the asset object to get full asset metadata including project name, symbol, and other details in a single request.

​
Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/transparency/1?expand=asset"

​
Example Response

{
  "id": 1,
  "asset_id": 345426,
  "summary": "",
  "created_at": 1755624545,
  "updated_at": 1758051174,
  "asset": {
    "id": 345426,
    "code": "AERO",
    "title": "Aerodrome Finance",
    "slug": "aerodrome-finance",
    "tag_line": null,
    "description": "",
    "image_url": "https://coin-images.coingecko.com/coins/images/31745/large/token.png?1696530564",
    "legacy_sector": null,
    "category": null,
    "is_supported": false,
    "updated_at": 1759454337,
    "sector_id": null,
    "type": null
  },
  "project_team": {
    "rating": 10,
    "max": 10
  },
  "token_allocation": {
    "rating": 17,
    "max": 18
  },
  "market_structure": {
    "rating": 7,
    "max": 7
  },
  "financial_disclosure": {
    "rating": 4,
    "max": 5
  }
}

​
Supported Options

NameTypeDetails
idpathThe ID of the transparency report to fetch
expandqueryExpand related data. Options: asset

​
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
assetobjectExpanded asset data (when expand=asset is used)
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

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Query Parameters

​
expand
enum<string>[]
Available options:
asset

Response