Build and Backtest Tokenomist API
Tokenomist

Claim Status

Claim status is the verification tier assigned to each token unlock in Tokenomist's three-stage claim lifecycle: Whitepaper (estimated from project docs), Committed (announced by team, not yet on-chain), or Completed (claimed and verified on-chain).
TradFi parallel — Like the stages of a corporate bond issuance: filed prospectus (Whitepaper), priced and allocated (Committed), settled and delivered (Completed).

Key Takeaways

  • 01
    Three verification tiers form Tokenomist's claim lifecycle: Whitepaper (estimated), Committed (announced), and Completed (on-chain verified)
  • 02
    Whitepaper claims carry the highest uncertainty — derived from project docs and subject to revision by the team
  • 03
    Committed claims represent explicit team announcements with significantly higher confidence than Whitepaper estimates
  • 04
    Completed claims are the terminal state with on-chain verification, providing trustless historical supply data
  • 05
    The Status column in Supply Analytics lets you filter by confidence level when building supply models or assessing risk

How It Works

Tokenomist assigns one of three claim statuses to every tracked token distribution, creating a confidence hierarchy that helps investors assess the reliability of upcoming supply events. The Status column in the Supply Analytics table displays this classification for each claim, making it immediately visible which events are projections, which are confirmed announcements, and which are historical facts. Whitepaper status is the earliest stage. These claims are derived from published tokenomics documents, vesting schedules, or governance proposals. They represent the project's stated intention but carry the highest uncertainty — teams may revise timelines, adjust allocations, or cancel distributions entirely. Committed status indicates that the project team has explicitly announced the distribution, often by preparing on-chain transactions or publishing execution timelines. While the tokens haven't moved yet, the team's public commitment significantly reduces the likelihood of changes. Completed status is the terminal state: tokens have been transferred on-chain and verified in the beneficiary's wallet. This three-stage system transforms raw unlock schedule data into actionable intelligence. By filtering the Supply Analytics table by status, you can separate high-confidence historical data (Completed) from forward-looking projections (Whitepaper) and near-term commitments (Committed). This distinction is critical for building accurate supply models — treating a Whitepaper-status claim with the same certainty as a Completed claim would misrepresent the actual supply trajectory.

Real World Examples

Hyperliquid Ecosystem Fund Status Transitions
View →
Hyperliquid's ecosystem fund allocations progress through all three statuses over time. Initial tokenomics documentation creates Whitepaper-status entries, team announcements shift them to Committed, and on-chain execution moves them to Completed — all trackable in the Supply Analytics Status column.
Arbitrum DAO Governance-Driven Status Changes
View →
Arbitrum's DAO treasury distributions demonstrate how governance votes trigger status transitions. A proposal approval moves a claim from Whitepaper to Committed status, and the subsequent on-chain execution moves it to Completed. The status column captures this governance-driven pipeline.
Starknet Vesting Schedule Status Tracking
View →
Starknet's investor and team vesting schedules initially appear as Whitepaper-status claims based on published tokenomics. As each tranche approaches its unlock date and the team prepares the distribution, claims transition to Committed — providing early signals of imminent supply expansion.
Optimism Retroactive Public Goods Funding
View →
Optimism's RetroPGF rounds create claims that move through all three statuses: Whitepaper when announced in the governance roadmap, Committed when round recipients are finalized, and Completed when tokens are distributed on-chain to contributors.

Frequently Asked Questions

How does Tokenomist determine a claim's status?
Tokenomist assigns status based on the source and verification level of the data. Whitepaper status comes from published tokenomics documents and vesting schedules. Committed status is assigned when the project team explicitly announces an upcoming distribution. Completed status requires on-chain transaction verification confirming tokens moved to the beneficiary's wallet.
Can a claim skip directly from Whitepaper to Completed?
Yes, in some cases. If a project executes a distribution without a prior public announcement, the claim may transition directly from Whitepaper to Completed once Tokenomist detects the on-chain transaction. However, most claims follow the full three-stage progression.
Should I treat Whitepaper and Committed claims differently in my analysis?
Absolutely. Whitepaper claims are estimates derived from project documentation and may change. Committed claims have been explicitly announced by the team and carry much higher confidence. When building supply models or assessing risk, weight Committed claims more heavily than Whitepaper claims, and treat Completed claims as confirmed historical data.
How often does Tokenomist update claim statuses?
Tokenomist continuously monitors on-chain activity and project announcements. Completed status updates occur as soon as on-chain transactions are verified. Whitepaper-to-Committed transitions are updated when project teams make public announcements or prepare on-chain distributions.

Related Terms

Track on Tokenomist

Supply-side analysis for educational purposes. Not financial advice. Verify assumption and precision labels on the relevant token page.
Tokenomist
Tokenomist.ai provides a complete solution for supply-side tokenomics data. Analyze future token emissions, track vesting schedules, and compare standardized tokenomics and allocation across projects to gain actionable insights