The Vault
Starter · $1

Memecoin Bot Starter

The free 3-part setup, running in 15 minutes: a scanner for new coins, an AI filter that kills the scams, and the one exit rule that matters.

First scan in 15 minutes

4 modules30 steps7 prompts6,282 words2 guides

Secure checkout with Stripe

$

You need

  • A Mac or Linux laptop (or a $4/mo VPS) that can stay on overnight, with Python 3.12 or newer
  • Claude Code (claude.com/claude-code) or any editor, plus an Anthropic API key from console.anthropic.com (a Grok key from x.ai works as the alternative)
  • A free Discord server you own, for the alert channel
  • Phantom (phantom.app) with a brand-new burner account holding pocket money only, never your main wallet
  • Free accounts: dexscreener.com and rugcheck.xyz need none, Jupiter's developer portal for a free API key, Helius free plan if you go auto mode
  • About 10 hours across a weekend and the patience to paper trade for seven nights before any real SOL moves

Module 1: What you are building, and the two modes

You are building a loop, not a magic box: a scanner finds fresh Solana coins, a scam filter kills the traps, an entry rule picks the moment, an exit engine decides when you are out, and a risk layer caps the damage. This module shows the whole machine on one page and makes you pick a mode: advisor mode (the bot finds, you tap buy) or auto mode (the bot buys through Jupiter).

  • 1See the five boxes
  • 2Pick advisor mode first (everyone starts here)
  • 3Understand auto mode before you want it
  • 4Know the three free data sources
  • 5Know what the bot cannot do
  • 6Set your one-night budget before you write code
  • 7Pick your build path for the weekend

Tools: Dexscreener API, RugCheck API, Jupiter Swap API v2, GMGN, Photon, Birdeye API

Full steps, prompts and settings unlock with the product.

Module 2: Environment setup (Python, Claude Code, .env, burner wallet, Discord webhook)

Thirty minutes of setup that prevents the two ways beginners lose everything: a leaked key and a main wallet connected to a bot. You end with a project folder, a virtual environment, a .env that holds secrets, a burner wallet with pocket money, and a Discord channel that receives a test message.

  • 1Install Python 3.12 or newer
  • 2Create the project folder and virtual environment
  • 3Let Claude Code scaffold the files
  • 4Write the .env file
  • 5Make a burner wallet in Phantom
  • 6Create the Discord webhook
  • 7Prove the two external calls work
  • 8Optional: Helius RPC for auto mode

Tools: Python, python-dotenv, solana-py + solders, Claude Code, Phantom, Discord webhooks, Helius RPC

Full steps, prompts and settings unlock with the product.

Module 3: The scanner loop

A sixty-line asyncio loop that pulls fresh Solana tokens from three free feeds every minute, looks up their live pair data in batches of 30, applies five filters, and prints the survivors. Read-only, no key, no wallet. By the end of this module your terminal shows real candidates scrolling by.

  • 1Understand the three fresh feeds
  • 2Batch the pair lookups
  • 3Set the five filters and know why each exists
  • 4Paste the scanner and run it
  • 5Keep a seen-set so alerts stay rare
  • 6Add the quote-token sanity check
  • 7Hand survivors to the filter

Tools: Dexscreener token-profiles and token-boosts feeds, Dexscreener /tokens/v1 batch pairs, RugCheck /v1/stats/new_tokens, httpx, Python asyncio

Full steps, prompts and settings unlock with the product.

Module 4: The scam filter (RugCheck facts plus the AI verdict)

Two layers. First a hard gate on binary on-chain facts from RugCheck: mint authority, freeze authority, LP lock, whale concentration, transfer tax. Only coins that pass get sent to the AI, which returns a structured CLEAN or SKIP with confidence and red flags, never free text. You get the code, the exact JSON schema, and the system prompt.

  • 1Pull the report and learn the fields
  • 2Strip the pools out of topHolders
  • 3Set the hard gate thresholds
  • 4Define the verdict schema and call Claude
  • 5Paste the system prompt as-is, then version it
  • 6Or use Grok for the verdict
  • 7Test on three known coins before trusting it
  • 8Wire it into main.py

Tools: RugCheck report endpoint, rugcheck.xyz, Claude API (structured outputs), Grok API (structured outputs), GMGN security panel, solscan.io

Full steps, prompts and settings unlock with the product.

Most people lose money trading. Only risk money you can afford to lose. This is not financial advice. Memecoins on Solana are among the highest-risk things you can buy; most go to zero within days, and the viral win-posts that inspired this build are single self-reported runs that are often paid promotion. This product is a research and discipline tool: a scanner, a red-flag filter and an exit enforcer. It cannot predict price and a CLEAN verdict means only that no known red flag was found at that moment. Never paste a seed phrase into any file, chat, bot or AI. Only a burner wallet with pocket money ever touches the bot, GMGN or Photon, and only in auto mode does a private key go in .env. Run paper mode for seven nights before any real SOL moves, and stop entirely if three weeks of single changes do not pass the Module 9 rule. Nothing here is financial, legal or tax advice.

Questions

Do I need to know Python to build this?

You need to be able to open Terminal, run the commands shown, and paste code into files. Claude Code does the scaffolding and fixes errors when you paste them back. Every skeleton here is under 80 lines and commented in plain words. If a line confuses you, paste it into Claude Code and ask what it does.

Why not just use the AI for everything, including the scam check?

Because mint authority, freeze authority, LP lock and transfer tax are facts on the chain, not opinions. The hard gate checks them directly and never gets talked out of it. The AI only weighs the gray areas after the facts pass, and it returns a structured CLEAN or SKIP so you never parse a paragraph.

Claude or Grok for the verdict?

Either. The code is written for the Claude API (claude-opus-5-5 by default, with claude-haiku-5-5 at $0.10 in and $0.50 out per million tokens as the cheap swap) and a drop-in Grok version (grok-4.7 at $2 in and $6 out) is included. Use the same system prompt, log which one produced each verdict, and keep whichever one skips the rugs over a few weeks.

How much does a night cost to run?

The data feeds are free. The AI filter runs only on coins that pass the hard gate, typically a few dozen a night at well under a cent each on Opus and a fraction of that on Haiku. A VPS is $4 a month on DigitalOcean's Basic Droplet or free on a Mac you already own. Trading fees only exist once you leave paper mode: 1 percent per trade on GMGN, or Jupiter's feeBps (50 bps on tokens under 24 hours old) plus priority fees in auto mode.

Can I run this on Freqtrade instead?

Not for Solana memecoins. Freqtrade is a centralized-exchange bot (Binance, Kraken, OKX, Bybit, Hyperliquid and others via ccxt). Module 7 gives you the exact Freqtrade config for the same risk rules so you can take them to a CEX later, but the Solana path is the standalone Python in this product.

What if the bot says CLEAN and the coin rugs anyway?

That is expected to happen eventually; RugCheck shows the current state, not intent, and tools cannot see that forty wallets are one person. The fixed size and hard stop cap the damage to 30 percent of 0.05 SOL in auto mode (or your tap in advisor mode). Then you find the fact that would have caught it, add it to hard_gate(), and restart the seven-night count.

Is advisor mode really a bot if I tap the buy?

Yes. The bot does the scanning, the filtering, the exit math and the alerting, which is 95 percent of the work and 100 percent of the discipline. Your tap on GMGN or Photon is the execution layer, and it keeps every private key out of every file. Many people never leave advisor mode and that is a fine outcome.

When do I move real money?

Only after seven paper nights pass all three parts of the Module 9 rule: every rule followed, zero CLEAN rugs, positive after estimated fees. Then 0.02 SOL per trade for seven more nights under the same rule. Then, and only then, 0.05 SOL. Most builds never get there, and the product has still done its job: you learned with zero at risk.

Plain English glossary

Mint
The address that identifies one token on Solana. You paste it into Dexscreener, RugCheck, GMGN or Photon to look the coin up.
Mint authority
A permission that lets someone create more of the coin. Revoked (null) is what you want; otherwise the supply can be inflated on you.
Freeze authority
A permission that lets someone freeze wallets so they cannot sell. Revoked is required; live freeze authority is an instant SKIP.
Liquidity pool (LP)
The pot of SOL and tokens that trades happen against. LP locked or burned means the creator cannot pull the pot out from under you.
Rug pull
When the creator removes the liquidity or dumps a hidden stash, leaving holders with tokens nobody can sell.
Honeypot
A coin you can buy but not sell, usually through a freeze, a blacklist or a 99 percent sell tax.
Token-2022
A newer Solana token standard that allows extensions like a transfer fee on every trade. Not bad by itself, but check transferFee.pct.
Slippage
How far the fill price may move from the quote before the order is rejected. 300 bps means 3 percent.
Basis points (bps)
Hundredths of a percent. 50 bps is 0.5 percent; Jupiter shows its fee as feeBps.
Lamports
The smallest unit of SOL. One SOL is 1,000,000,000 lamports; Jupiter's amount field uses them.
Hard stop
A safety stop that sells everything when the price falls a fixed percent below your entry, here minus 30 percent.
Trailing stop
A stop that follows the price up and never moves down; here it sells if price falls 25 percent from its peak after you took half at 2x.
Paper trading (dry run)
Running the whole bot with fake fills and real prices so you can judge the rules with zero money at risk.
Burner wallet
A fresh wallet holding only pocket money, used for anything connected to a bot or a trading site, so a leak cannot reach your main funds.
Kill switch
Here, a file named STOP in the project folder. If it exists the bot refuses to open any trade.

One dollar. Start tonight.