Build and Backtest Tokenomist API
Tokenomist

Whitepaper Schedule

The whitepaper schedule is the original token unlock timetable as documented in a project's whitepaper or tokenomics documentation. It serves as the baseline estimate before any team announcements or on-chain deviations, and is the first stage of Tokenomist's claim lifecycle.
TradFi parallel — Like a company's prospectus detailing the planned lockup expiry dates for IPO shares — the initial schedule that sets market expectations, even though actual selling may differ.

Key Takeaways

  • 01
    The whitepaper schedule is the original token distribution timetable published in the project's documentation — it is an estimate, not a guarantee
  • 02
    In Tokenomist's claim lifecycle, whitepaper is the first stage (Whitepaper → Committed → Completed), representing the lowest-confidence projection
  • 03
    Displayed with a blue info badge in Supply Analytics with the explicit note that amounts may change before the actual claim
  • 04
    Serves as the baseline against which committed claims are compared — Tokenomist flags MATCH or MISMATCH when the team announces the actual amount
  • 05
    Teams may deviate from whitepaper schedules due to market conditions, governance decisions, or revised tokenomics

How It Works

Every token project publishes a distribution plan that specifies when and how tokens will be released to various stakeholders — team members, investors, ecosystem funds, community allocations, and treasury reserves. This plan, typically found in the project's whitepaper or tokenomics documentation, is what Tokenomist calls the whitepaper schedule. It is the foundational reference point against which all subsequent claims are measured. On the Tokenomist platform, whitepaper-status claims are displayed with a blue info badge in Supply Analytics, accompanied by the note: "Estimated from the project's whitepaper. May change before the actual claim." This explicit framing is important because whitepaper schedules are projections, not guarantees. Teams may accelerate, delay, or modify their distribution plans based on market conditions, governance votes, treasury management decisions, or protocol milestones. Tokenomist treats these as estimates until the team commits to a specific amount. The whitepaper schedule is the first stage of Tokenomist's three-stage claim lifecycle: Whitepaper → Committed → Completed. As a claim date approaches and the team announces the actual amount, the status transitions from whitepaper to committed. Tokenomist then compares the committed amount against the whitepaper baseline, flagging whether they match or diverge. This progression from estimate to commitment to execution gives users increasing confidence in upcoming supply changes and makes deviations from the original plan immediately visible.

Real World Examples

Hyperliquid Whitepaper Allocation Timeline
View →
Hyperliquid's whitepaper outlines a multi-year distribution schedule across team, ecosystem, and community allocations. Tokenomist imports this schedule and displays each upcoming unlock with a whitepaper badge until the team announces the actual committed amount, allowing users to track deviations from the original plan.
Arbitrum Foundation Distribution Schedule
View →
Arbitrum's tokenomics documentation specified a detailed vesting timeline for team, investor, and DAO treasury allocations. As the project matured, some distributions deviated from the original whitepaper schedule due to governance proposals and treasury management decisions, demonstrating why whitepaper estimates require ongoing verification.
Optimism Retroactive Public Goods Funding
View →
Optimism's whitepaper outlined broad allocation categories but left specific distribution timing to future governance decisions. This created a dynamic whitepaper schedule where Tokenomist tracks both the original allocation percentages and the actual distribution cadence as the Optimism Collective executes its funding rounds.

Frequently Asked Questions

How reliable is a whitepaper schedule for predicting actual unlocks?
Whitepaper schedules are directionally useful but not guaranteed. They represent the team's original plan and set market expectations, but actual claim amounts and timing can differ. Tokenomist addresses this by tracking claims through three stages — whitepaper, committed, and completed — so you can see exactly when estimates transition to firm commitments and how much they deviate.
What does the blue badge mean in Supply Analytics?
The blue info badge indicates a whitepaper-status claim — an upcoming unlock whose amount and timing are estimated from the project's documentation. It has not yet been confirmed by the team. When the team announces the actual amount, the status transitions to committed (yellow badge) and Tokenomist flags whether the committed amount matches the whitepaper estimate.
Why do teams deviate from their whitepaper schedules?
Common reasons include governance votes that alter distribution plans, market conditions that lead teams to delay or accelerate claims, treasury management strategies, protocol milestone dependencies, and revised tokenomics. Tokenomist tracks these deviations through the MATCH/MISMATCH system when claims transition from whitepaper to committed status.
How does Tokenomist source whitepaper schedule data?
Tokenomist's research team extracts distribution schedules from official project documentation including whitepapers, tokenomics blog posts, governance proposals, and smart contract analysis. This data is continuously updated as projects publish revisions. The Supply Analytics tab on each token page shows the current whitepaper schedule alongside any committed or completed claims.

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