Services Approach Projects Back to Home
Project · Open Source

hades-kat-bot

An automated trading bot for Solana's pump.fun ecosystem. Four independent discovery feeds surface candidate tokens, seven pluggable buy strategies decide which to take, and a layered exit manager — hard stops, take-profits, dynamic trails, plus optional time and velocity exits — handles the close.

Rust 1.85+ Edition 2024 4 Discovery Feeds 7 Buy Strategies Dry-Run Mode
View on GitHub All Projects

Overview

hades-kat-bot is the most expansive of our open trading systems. It pipes four independent discovery feeds — Birdeye trending, GeckoTerminal trending, target-wallet copy-trading, and new pump.fun launches — into a candidate queue, scores each candidate through any subset of seven pluggable strategies, and executes locally signed buys when a strategy fires.

Once in a position, layered exit logic takes over: hard stops, hard take-profits, dynamic trailing stops, and optional time-in-position and velocity-based exits. The full trade lifecycle lands in a JSONL trade journal for offline analysis.

Discovery Feeds

Each feed is independently toggleable in the config.

  • Birdeye trending — top-mover candidates from Birdeye's trending API.
  • GeckoTerminal trending — cross-DEX trending tokens from GeckoTerminal.
  • Wallet copy-trading — mirrors buys from a configured list of target wallets.
  • New pump.fun launches — fresh creations off the bonding curve.

Buy Strategies

Pluggable, composable, individually toggleable:

  • Momentum — recent price acceleration.
  • Mean Reversion — pullbacks against a trend.
  • Breakout — price exits a consolidation range.
  • Volume Spike — abnormal trade volume detection.
  • Holder Growth — rapid unique-buyer expansion.
  • Liquidity Depth — sufficient depth-of-book to enter.
  • PumpSwap Sniper — graduation-window entry on PumpSwap.

Setup

1. Clone and prepare config

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

2. Build

~/build
$ cargo build --release

3. Test first in dry-run mode

~/dry-run
# Simulates everything without sending real transactions. $ cargo run --release -- --dry-run

4. Go live

~/live
$ cargo run --release

Trade Journal

Every entry, exit, and decision lands as a JSONL line in the trade journal — append-only, line-delimited, perfect for piping into jq or loading into a notebook. Audit trail is the bot's first-class output; PnL is a derived view of the journal.

This bot trades real funds on Solana mainnet. It takes full custody of the wallet and buys / sells tokens autonomously. Always test with --dry-run first using minimal position sizes. Educational software, provided AS IS, no warranty — all financial risk is yours.