The Vault
Flagship

The Overnight Bot Blueprint

Build the full memecoin trading bot in a weekend, scanner to scam filter to exits to risk code, run it in paper mode for seven nights, and know by the data whether it deserves real money.

Scanner printing live candidates in 20 minutes, full build in a weekend, first paper night that same night

9 modules68 steps15 prompts12,395 words6 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.

Module 5: Entry rules (what makes a coin tradeable, and the pullback rule)

CLEAN is not a ticket. This module adds the entry layer: a coin must be liquid enough for your size, still attracting buyers, and, the rule that saves the most money, you buy the pullback, not the green candle. You get the exact numbers, the one-minute check, and where the trade physically happens in advisor mode.

  • 1Size against liquidity, not against your gut
  • 2Require money still arriving
  • 3The pullback rule, in numbers
  • 4Re-run the hard gate right before the buy
  • 5Advisor mode: place the entry on GMGN or Photon
  • 6Auto mode: the entry is a function
  • 7One entry per coin, ever

Tools: GMGN, Photon, Dexscreener pair row, Jupiter /order quote, GMGN fees and settings

Full steps, prompts and settings unlock with the product.

Module 6: The exit engine

The edge in every bot story is the exit decided before the buy. This module gives you five exits as one pure function (take half at 2x, hard stop at minus 30 percent, liquidity-drain exit, trailing stop after the half-sale, time stop) plus the exact way to type the same rules into a GMGN or Photon ticket in advisor mode.

  • 1Write the exits before you own anything
  • 2Order matters inside check_exit
  • 3Feed it live price and liquidity
  • 4Take half at 2x, then trail the rest
  • 5Advisor mode: type the exits into the GMGN ticket
  • 6Advisor mode: Photon version
  • 7The liquidity-drain exit needs you in advisor mode
  • 8Never move a stop

Tools: Jupiter Price API v3, Dexscreener /token-pairs, GMGN Auto trading (TP/SL, trailing), GMGN trailing stop loss, Photon

Full steps, prompts and settings unlock with the product.

Module 7: The risk code (size, max open, daily cap, kill switch; Freqtrade and standalone)

The $20k-to-$0 story in the source reels had a working bot and no risk layer. This module gives you one: fixed size, max open trades, a daily loss cap, a losing-streak pause and a kill-switch file, as a 50-line standalone class every buy must pass. Then the same rules as an exact Freqtrade config for the day you take them to a centralized exchange.

  • 1Fixed size, full stop
  • 2Max open trades and the daily cap
  • 3Losing-streak pause and the kill switch
  • 4State survives restarts
  • 5The same rules in Freqtrade, for a CEX
  • 6Freqtrade protections are the auto-shutdown
  • 7Prove the risk layer with a bad night on paper

Tools: Freqtrade, Freqtrade configuration docs, Freqtrade stoploss docs, Freqtrade protections, Python pathlib + json

Full steps, prompts and settings unlock with the product.

Module 8: Overnight run and monitoring

A bot that dies at 1am and nobody notices is worse than no bot. This module runs it as a launchd agent on a Mac (or a systemd service on a $4 VPS), gives it rotating logs, sends only the alerts that matter to Discord, and hands you a seven-item morning checklist.

  • 1Decide where it runs
  • 2Add alerts.py and use it everywhere
  • 3Alert on five events only
  • 4Install the launchd agent
  • 5Keep secrets out of the plist
  • 6VPS version in one paragraph
  • 7Graceful shutdown
  • 8The morning review (seven items, five minutes)

Tools: launchd (macOS), DigitalOcean Droplet, Hetzner Cloud, Discord webhooks and rate limits, Python logging.handlers

Full steps, prompts and settings unlock with the product.

Module 9: Paper trade for seven nights, then decide

The log template, the three-part pass/fail rule, and the discipline to change one number at a time. Most builds fail this gate, and that is the product working: you find out with zero SOL at risk. The ones that pass move to 0.02 SOL for seven more nights under the same rule.

  • 1Paper mode means the bot records, you do nothing
  • 2Write the log the same way every time
  • 3Subtract fees you did not pay
  • 4The three-part pass rule
  • 5What a fail means and what to change
  • 6What a pass unlocks
  • 7Review the SKIPs without flinching
  • 8Keep the honest frame

Tools: dexscreener.com, rugcheck.xyz, Jupiter /order quote, GMGN, Photon

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.

Get The Overnight Bot Blueprint.