Tokenomics Analyzer Agent 🔍

A 3-agent AI swarm that cross-references live on-chain data with whitepaper claims to surface tokenomics red flags and rug pull signals.

---

What This Does

You give it:

1. A Solana token mint address
2. The project's tokenomics text (from their whitepaper, docs, or website)

It gives you:

• On-chain supply analysis (mint authority, freeze authority, holder concentration)
• Whitepaper claims breakdown (allocations, vesting, inflation)
• Cross-reference report — where the whitepaper LIES vs what the blockchain SHOWS
• Risk score 1-10 + final investor verdict

---

Setup (Step by Step)

1. Install Node.js

Download from https://nodejs.org (get the LTS version)

2. Download this project

Save all files into a folder called tokenomics-analyzer

3. Install dependencies

Open your terminal in that folder and run:

BASH
npm install  

4. Set up your API keys

Copy .env.example to a new file called .env:

BASH
cp .env.example .env  

Then open .env and fill in your keys:

SWARMS_API_KEY=your_swarms_api_key_here  
HELIUS_API_KEY=your_helius_api_key_here  
CREATOR_WALLET_ADDRESS=your_solana_public_key_here  
CREATOR_PRIVATE_KEY=your_solana_private_key_here  

Where to get each key:

• Swarms API Key → https://swarms.world/platform/api-keys
• Helius API Key → https://helius.dev (free account)
• Solana Wallet → Install Phantom at https://phantom.app

5. Test the agent

BASH
npm start  

This runs a sample analysis on USDC. You should see a full report printed in your terminal.

6. Customize for a real token

Open agent.js and scroll to the bottom. Change:

JS
const EXAMPLE_TOKEN = "paste-token-mint-address-here";  
const EXAMPLE_WHITEPAPER_TEXT = `paste tokenomics text here`;  

7. Publish to Swarms Marketplace

Once you're happy with the output:

BASH
npm run publish-agent  

This lists your agent on the marketplace with Frenzy Mode tokenization enabled.

---

How to Use After Buying

JAVASCRIPT
import { analyzeTokenomics } from './agent.js';

const result = await analyzeTokenomics({  
  tokenAddress: "TOKEN_MINT_ADDRESS_HERE",  
  whitepaperText: `  
    Paste the tokenomics section from the project's whitepaper here.  
    Include: allocations, vesting schedule, total supply, use of funds, etc.  
  `  
});  

---

Architecture

Input: Token Address + Whitepaper Text  
              ↓  
[Agent 1] On-Chain Data Interpreter  
  → Reads live blockchain: supply, mint authority, holder concentration  
              ↓  
[Agent 2] Whitepaper Tokenomics Extractor  
  → Parses whitepaper: allocations, vesting, inflation, red flags  
              ↓  
[Agent 3] Cross-Reference Judge  
  → Compares CLAIMS vs REALITY → flags discrepancies → delivers verdict  
              ↓  
Output: Full Intelligence Report + Risk Score  

---

Files

---

Support

Built for the Swarms ACM Hackathon 2026.
Questions? Join the Swarms Discord: https://discord.gg/VK9jp9sXwJ

Source: https://github.com/preshiy/tokenomics-analyzer