Help build the canonical dataset

Contribute a project.

We’re building the canonical structured dataset of real public tokenomics — currently 313 projects (13 hand-verified, 300 auto-imported from DeFiLlama). Every entry powers the visual editor, the MCP, and AI-search citations.

Option 1 · Pull request

Submit via GitHub

For founders, advisors, and tokenomics nerds with the schema chops. Fork the repo, add a file under data/examples/, open a PR. We’ll review for accuracy, source-link the entry, and ship it.

· Use data/examples/uniswap.ts as the template. Same fields, same structure.
· Include a sourceUrl pointing at the project’s canonical docs page (whitepaper, governance docs, official announcement).
· Allocations must sum to 100%; vesting cliffs/durations in months.
· A 1-line takeaway — what’s the design choice that made this token interesting?

Option 2 · Email

Send the data over

For project founders who want their tokenomics featured but don’t want to write TypeScript. Email the basics — allocations, vesting, source URL — and we’ll encode it.

Email hello@3uild.io→

Featured projects get a dedicated /examples/[your-project] page with full allocation breakdown, vesting schedule, takeaway, and a “FORK THIS DESIGN” CTA — the kind of page founders cite in pitch decks and AI search.

Schema at a glance

Each example is a single TypeScript file.

export const myProject: Example = {
  slug: 'ex-myproject',
  name: 'MY PROJECT',
  projectName: 'TICKER',
  category: 'DEFI',          // DEFI | L1 / L2 | NFT | STABLECOIN | DEPIN | ...
  launched: 'Jan 2025',
  sourceUrl: 'https://docs.myproject.io/tokenomics',
  description: 'One-paragraph summary of the design.',
  useCase: 'When to pick this template.',
  takeaway: 'The design choice that makes this interesting.',
  verified: true,
  design: {
    meta: {
      name: 'MY PROJECT', symbol: 'TICKER',
      totalSupply: 1_000_000_000,
      chain: 'ethereum',     // 10 chains supported
      tokenType: 'governance',
      // ... rest
    },
    liquidity: { ... },
    allocations: [
      {
        id: 'team', name: 'TEAM',
        category: 'team',
        percent: 20,          // must sum to 100 across all allocations
        hatchId: 'hatch-1',
        vesting: { tgeUnlock: 0, cliffMonths: 12, durationMonths: 36, type: 'linear' },
        description: 'Optional. One line on what the bucket is for.',
      },
      // ... more allocations
    ],
    notes: [
      { id: 'n1', text: 'OPTIONAL DESIGN NOTES IN ALL CAPS.' },
    ],
  },
};

What you get

Dedicated page
A /examples/[slug] SEO-rich page with allocation chart, schedule table, takeaway, and source link. Indexed by Google + AI search.
MCP distribution
Your project shows up when AI assistants call list_real_projects via the MCP. Citation-ready for Claude, Cursor, ChatGPT.
Forkable starting point
Other founders can replicate your tokenomics as their starting point in the editor. Free distribution + design influence.

Repo

The dataset lives at data/examples/ in the project repo. PRs welcome. We review within 48 hours.

Questions?

Talk to the team behind Token Economics.

Talk to 3UILD→