strategy-dev

Set up your first Tokenomics Studio project (multi-token IR workspace)

Live holder data, unlock simulator, public report URL, B2B API keys

30 min · intermediate

What you'll have when finished

  • Have one project with at least 1 token + 1 unlock entry
  • Live holder concentration visible (top-10 / top-50 / Gini)
  • One simulated unlock-impact result + public report URL ready

Before you start

  • Simulator REQUIRES real pool reserves — we do not fabricate liquidity from market cap
  • API key plaintext is shown ONCE — store in a real secret manager (1Password / Vault), not a notes app
  • "Data unavailable" is honest behavior, not a bug — better than imputed numbers in investor reports

Walkthrough

  1. Open Tokenomics Studio + create a project

    Elite → Tokenomics Studio. Click + next to Projects. Project name = your token / DAO name. Plan: Starter (1 token contract — single-token projects) / Growth (5 contracts — multi-chain) / Enterprise (50 contracts — agencies). Pick the right tier.

    Success criteria: Project visible in sidebar with chosen plan

  2. Add your first token

    Project detail → add token with contract address + chain + decimals. System validates the contract is real ERC-20. Multi-chain projects: each chain version = one "token contract" slot.

    Success criteria: Token validated and listed in the project

  3. Configure explorer API key for your chain

    BYO model. Get an API key from your chain's explorer (Etherscan / Polygonscan / BscScan / Basescan / Arbiscan / etc). Paste it in the chain's field. Without your key, holder data may show "Data unavailable" — honest scarcity beats imputed numbers.

    Success criteria: Explorer key configured for at least one chain you use

  4. Run Holders tab analysis

    Holders tab pulls real top-50 from the explorer. Reads: top-10 % concentration, top-50 % concentration, Gini coefficient (0=equal, 1=monopoly). Labels: known CEX hot wallets, DEX routers, burn addresses — never invented "Whale" labels.

    Success criteria: Top-50 holders visible with concentration % + Gini

  5. Add at least one unlock entry

    Unlocks tab → Add. Date + amount + % of supply + recipient + notes. Build the FULL 24-month calendar over time. Start with your next 3 known unlocks for the first session.

    Success criteria: At least one unlock entry in the calendar

  6. Run the unlock-impact simulator with REAL pool reserves

    Pick an unlock entry → Simulate. Required input: your current DEX pool reserves (query Uniswap directly or use DEX Liquidity Optimizer). Output: single-shot worst-case price impact + sliced TWAP scenario. Constant-product math (V2; reasonable V3 approximation near current price).

    Success criteria: Simulation result visible with single-shot and TWAP impact %

  7. Enable public investor report + issue API key

    Toggle Public Report ON → get haythix.com/tokenomics/r/{slug} URL. Share with investors. API Keys tab → Issue → COPY THE PLAINTEXT NOW (shown once). Use header X-API-Key on /api/v1/tokenomics/projects/{id}/* endpoints to embed live data on your IR site.

    Success criteria: Public report URL saved AND API key plaintext stored in your secret manager

What's next

You have a real IR workspace. Habit: monthly cadence — refresh holder data, add new unlock entries as they appear in your tokenomics calendar, re-simulate impacts when pool reserves change materially. Share the public report URL in every investor / MM conversation; embed via API key on your IR site for always-fresh data.