Services Approach Projects Back to Home
Project · Open Source

hades-research-bot

A Rust command-line tool that performs deep, read-only analysis of pump.fun token launches on Solana. Feed it a list of mints; get back structured JSON reports detailing creator behavior, trade distribution, and volume metrics from the first 15 minutes of existence.

Rust 1.85+ Edition 2024 Read-Only No Wallet Required JSON Output
View on GitHub All Projects

Overview

hades-research-bot is a focused research utility — it does not trade, hold custody, or touch a wallet. It accepts a list of pump.fun mint addresses and replays each one's first 15 minutes on-chain, classifying every transaction as a create, buy, or sell, and aggregating the result into a clean JSON report. The output is suitable for downstream analysis, behavioral modeling, or feeding into a notebook.

What Each Report Contains

  • Creator identification — the wallet that deployed the token.
  • Transaction classification — every tx tagged as create, buy, or sell.
  • Creator activity timeline — every action the deployer wallet took during the window.
  • Trade statistics — counts, volumes, top trades, and the distribution of trade sizes.
  • Wallet analytics — unique buyer / seller counts, repeat-trader patterns.
  • Volume metrics — aggregated SOL volume across the analysis window.

Requirements

  • Rust toolchain — 1.85+ (developed on 1.89), edition 2024.
  • Solana mainnet RPC endpoint supporting getSignaturesForAddress and getTransaction.
  • No wallet, keypair, or SOL required — this is a pure read-only tool.

Setup

1. Clone and configure

~/install
$ git clone https://github.com/hadesbaker/hades-research-bot.git $ cd hades-research-bot $ cp .env.example .env

2. Configure .env

  • RPC_URL — required Solana mainnet RPC endpoint.
  • TOKEN_ADDRESSES — comma-separated list of pump.fun mint addresses to analyze.
  • RUST_LOG — optional verbosity control (info, debug, etc.).

3. Build and run

~/run
$ cargo build --release $ cargo run --release

Output

Each analysis produces results/<mint>.json containing the creator timeline, highlights (trade counts, volumes, top trades), and statistical distributions of trade behavior. The schema is stable and ready to feed into a notebook, dashboard, or downstream pipeline.

This is a read-only research tool. It does not require a wallet, does not move funds, and cannot trade. Provided for educational and informational purposes only; no warranty is offered for the analysis output.