Elite Features

Tokenomics Studio

9 min read

What it is

Multi-token issuer workspace. Create a project, add your token contracts (across 10 chains), schedule the unlock calendar, run live holder analysis from real chain explorers (top-10 / top-50 concentration + Gini coefficient), simulate unlock price impact on real Uniswap V2 / V3 pool reserves (constant-product math), share a public investor report URL, and issue SHA-256-hashed B2B API keys (plaintext shown ONCE) for embedding the data on your own IR / DD site. 3 plan tiers: Starter (1 token), Growth (5 tokens), Enterprise (50 tokens).

How to think about it

Bubblemaps does holder maps. CertiK does audit reports. Messari does disclosures. None combines all three with API access AND the discipline to surface "pending" / "unavailable" when chain data is not available. Tokenomics Studio is the fourth-party integration of all those, with verifiability as the forcing function. Sister to Tokenomics Advisor (one-shot AI analysis); Studio is the ongoing workspace for live IR data.

Step-by-step

  1. Read the "What is this tool" panel + pick a plan

    4-step usage walkthrough in the teal expandable card. Pick plan: Starter (1 token contract — single-token projects), Growth (5 contracts — multi-chain deployments or DAOs with several tokens), Enterprise (50 contracts — agencies / large protocols). A "token contract" = one ERC-20 on one chain.

  2. Create a project + add tokens

    Project = your IR workspace. Inside, add tokens by contract + chain + decimals. System validates the contract is real ERC-20. 10 chains supported (Ethereum, Polygon, BNB Chain, Arbitrum, Base, Optimism, Avalanche, Blast, Linea, Scroll).

  3. Add explorer API keys for live holder data

    Each chain has a different explorer (Etherscan / Polygonscan / BscScan / Arbiscan / Basescan / Snowscan / etc). For full live data, paste YOUR explorer API key for each chain you use — BYO model. If no key is set, the row shows "pending" / "unavailable" instead of imputed numbers. Honest scarcity beats fabricated data.

  4. Run Holders tab analysis

    Pulls real top-50 holders from the explorer. Computes: top-10 % concentration, top-50 % concentration, Gini coefficient (0 = perfect equality, 1 = one wallet owns everything). Conservative wallet labels only — known CEX hot wallets (Binance / Coinbase), Uniswap routers, burn addresses, the zero address. NEVER invented "Whale 1" / "Whale 2" tags. Unknown EOAs stay raw.

  5. Add unlock calendar entries

    Schedule every vesting cliff + team unlock + treasury move + LP unlock. Each entry: date + amount + % of supply + recipient + notes. Build the FULL calendar over the next 24 months. The calendar drives the simulator and the public report.

  6. Run unlock-impact simulator

    For any unlock entry, the simulator computes price impact on your real DEX pool reserves using Uniswap V2 constant-product math (also a good approximation for V3 near current price). Two scenarios: single-shot worst case (recipient dumps the entire unlock immediately) + sliced TWAP (recipient sells over N days). REQUIRES your real pool reserves as input — we do NOT fabricate liquidity from CoinGecko market cap.

  7. Enable public investor report

    Toggle Public Report ON. Get a URL like haythix.com/tokenomics/r/{slug}. Share with investors / market makers / listing teams. The public report shows: token + unlock calendar + holder concentration + simulated impacts. Never exposes: userId, project members, API key hashes, recipient PII, internal notes.

  8. Issue B2B API keys

    API Keys tab → Issue. The plaintext key is shown ONCE — copy it immediately, you cannot recover it (revoke + reissue if lost). Use header X-API-Key on /api/v1/tokenomics/projects/{id}/* endpoints. Embed live holder + unlock data on your own IR / DD site, dashboard, internal Slack bot, etc.

Tips & pitfalls

  • Conservative wallet labels only. We never invent "Whale 1" or "Strategic LP" labels — those mislead investors. If we cannot identify the wallet from a known set (CEX hot wallets, DEX routers, burn addresses), it stays as a raw EOA. Investors prefer honest unknown over confident fiction.
  • Unlock simulator REQUIRES real pool reserves as input. We do not fabricate liquidity from market cap or CoinGecko volume. If you do not have pool reserves at hand, query Uniswap V3 directly or use DEX Liquidity Optimizer for the math. Without real reserves, the simulation is misleading.
  • API keys are SHA-256-hashed at rest. The plaintext is shown ONCE on issuance — there is no recovery path. If you lose the plaintext, revoke the key and issue a new one. Store plaintexts in a real secret manager (1Password, AWS Secrets Manager, Vault), not in a notes app.
  • Public investor report URL is your competitive moat. Most issuers send PDFs by email. You send a real-time URL that always shows the current state — holder concentration, next unlock dates, simulated impacts. Investors prefer this over emailed PDFs because it cannot go stale between email and read.
  • "Data unavailable" is honest behavior, not a bug. If an explorer is rate-limited or does not expose top-holders for your chain, the row shows "Data unavailable" instead of inventing numbers. This protects your investor report from looking sloppy when public data is genuinely missing.
  • Multi-token plans (Growth / Enterprise) shine for multi-chain deployments. If you have ETH + ARB + BASE versions of the same token via official bridges, treat them as 3 separate "token contracts" — Growth plan ($5/contract slots) handles this.
  • BYO explorer keys. Different explorers have different rate limits and free-tier quotas. Use YOUR key for chains you actively use. Default Etherscan free tier is ~5 req/sec which is fine for ad-hoc analysis; for production embedding, get a paid key.
  • Sister tools: Tokenomics Advisor (one-shot AI analysis of whitepaper PDF). Volume Health Widget (broadcast organic-activity score). DEX Liquidity Optimizer (issuer launch planning). Studio is the ONGOING workspace; the others are point tools.