Blockworks: Token Transparency Framework for onchain disclosure
B-1 and B-2 token filings, four-category completeness scoring, Transparency Alliance, and the Blockworks Research API list endpoint for builders and IR teams.
devrels.xyz/a/245short linkBlockworks: Token Transparency Framework for onchain disclosure. The Token Transparency Framework (TTF) is Blockworks' open standard for material token disclosures — project and team, supply and allocation, market structure, and financial data — published as a public filings board and machine-readable reports.
Why it exists
Equity markets have S-1 / 10-K shaped habits. Token markets mostly had PDFs, Notion pages, and Discord pins. TTF tries to make disclosure comparable: same categories, versioned templates, completeness labels, and a single registry so investors, exchanges, and builders can see what is on the record without scraping ten blogs.
Launched mid-2025 and expanded through 2026 with the Transparency Alliance (exchanges, asset managers, infra names listed on the TTF site). Filings are assessed for completeness, not whether the token is a good buy.
Filing types: B-1 and B-2
| Type | Role | Analogy |
|---|---|---|
| B-1 | One-time filing around token generation / early public life | Closer to an S-1-style snapshot |
| B-2 | Continuously updated filing for mature protocols | Ongoing public disclosure, not a single launch packet |
The public board (as of late August 2026) tracks on the order of 100+ disclosures, mix of issuer-filed and Blockworks-sourced rows, with Complete vs Partial labels and current vs outdated status. Solana-native names appear in the set (e.g. Jito, Metaplex, MetaDAO, DoubleZero, Flash Trade, Ore — completeness varies by filing).
Four scoring categories
Criteria are weighted by materiality and rolled into category scores (and an aggregate transparency score in the original methodology). The four buckets:
| Category | What filers are expected to put on record |
|---|---|
| Project & team | Who builds/governs the protocol, entity structure, key people, conflicts |
| Token allocation | Supply, unlock schedules, insider/community/treasury splits, emissions |
| Market structure | How the token trades and is used — venues, utility, transfer restrictions |
| Financial disclosure | Treasury, revenue, runway-style facts the market needs to price risk |
A Partial label means specific gaps remain; Complete means the template items for that version are filled. Always read the filing — the label is a checklist status, not a grade.
How issuers file
- Start from the public board CTA: ir.blockworks.com (“Start Your Filing”).
- Choose B-1 vs B-2 based on lifecycle (TGE packet vs ongoing protocol).
- Fill each category with primary sources (on-chain program IDs, multisigs, unlock contracts, audited financials where they exist).
- Publish; monitor completeness gaps and keep B-2 filings current so status does not flip to outdated.
DevRel angle: treat TTF like a living product surface. Link the filing from docs, keep unlock tables in sync with the on-chain schedule, and version announcements when allocation changes.
API for builders
Blockworks Research documents a paginated list of TTF reports — scores across the four categories — powering the public page:
# See live path + auth in Blockworks Research docs
# GET token transparency reports (paginated)
# https://docs.blockworksresearch.com/api-reference/token-transparency/list
curl -sS "https://api.blockworks.com/…" \
-H "Authorization: Bearer $BLOCKWORKS_API_KEY" \
-H "Accept: application/json"
# Response shape (illustrative): reports[] with category scores, total, pageUse cases: portfolio dashboards, exchange listing checklists, agent research tools that refuse to recommend tokens with empty allocation sections, internal IR monitors for “outdated” flags.
For the broader Blockworks/Messari data stack (REV, research warehouse, MCP), see Blockworks after Messari.
What TTF is not
- Not a legal prospectus substitute or securities opinion.
- Not a security audit or code verification standard.
- Not Solana-only — multi-chain registry; Solana projects are one cohort among many.
- Completeness ≠ quality: a Complete filing can still describe a weak business.
People and links
| Surface | Link |
|---|---|
| Public registry | blockworks.com/token-transparency |
| Start filing (IR) | ir.blockworks.com |
| Launch write-up | A new framework for token market transparency |
| Alliance | Transparency Alliance announcement |
| API | List Token Transparency Reports |
| X | @Blockworks |
| Org | /organisations/blockworks |
Resources
Keep reading
Not every “swap API” is the same product. Here is what each aggregator layer actually gives your app — routing engines, landing, fees, AI tooling, and when to call whom.
One order ticket, multi-venue perps execution, optional lending boost, and a public Trading API — how Imperial’s router works for traders and integrators.
Blockworks is no longer just research podcasts. After the Messari acquisition, the product surface for builders is a dual API stack, deep Solana analytics (REV, DEX, DATs), and institutional Lightspeed IR. Here is the map: what to call, when not to use it, and a research clip on Jupiter distribution.
Get new articles in your inbox
Technical deep-dives on Solana tooling, infrastructure, and ecosystem. No noise.
