What it does
buy,sell(any percent),portfolio,historyandreset, with a starting balance you choose.- Fills at real Jupiter routes across every Solana DEX, with the route and price impact shown.
- Portfolio values each position at what you would actually receive selling it now, not at the chart price.
- Average-cost accounting, realized and open PnL, and win rate.
- No wallet, no keys, no real SOL. The portfolio is a JSON file in your home folder.
Quick start
You need Node.js 22 or newer. Nothing else: no install step, no dependencies, no API keys.
npx -y github:blixtrade/memecoin-paper-trading buy <mint> 0.5
Example output
Real output from a live run.
$ paper buy 9hjBLBrc7WZW2H8UQvBAvG5WiTZotXUv2Bdcn4f4pump 1
Bought 5.2K DCTY for 1.0000 SOL via Meteora DLMM
Paper SOL left: 9.0000 SOL
$ paper buy DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 0.5
Bought 15.72M Bonk for 0.5000 SOL via BisonFi → Scorch
Paper SOL left: 8.5000 SOL
$ paper portfolio
Paper portfolio ~/.blix-paper/portfolio.json
Equity 10.0020 SOL +0.0020 SOL (0.0%) since starting with 10.00 SOL
Cash 8.5000 SOL
Realized 0.0000 SOL
Token Tokens Cost Sell now PnL ROI Mint
DCTY 5.2K 1.0000 1.0022 +0.0022 0% 9hjBLBrc7WZW2H8UQvBAvG5WiTZotXUv2Bdcn4f4pump
Bonk 15.72M 0.5000 0.4998 -0.0002 0% DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
"Sell now" is a live Jupiter quote for the whole position, including price impact.
How it works
- Quotes come from Jupiter's free API; token decimals from Jupiter's price API.
- The portfolio file is written atomically, so a crash never corrupts it.
Limits
- Paper fills do not pay network or priority fees, and nothing is front-run, so real results will be a little worse.
- A token with no Jupiter route (no liquidity yet) cannot be bought or valued.
Questions
Are the prices real?
Yes. Every fill is a live Jupiter quote, including price impact, so a large order fills worse, the same as it would for real.
Where is my portfolio kept?
In a JSON file in your home folder. Nothing leaves your computer except the price requests.
Can I lose real money?
No. There is no wallet and no signing. It only ever spends fake SOL.
Contribute
It is a small, dependency-free codebase and the tests run offline. Pick a good first issue: each one names the exact files to change. Pull requests are reviewed the same day.
Want it live, with AI on every coin?
Memecoin Paper Trading is the free, simple version. BLIX runs it live in the browser with AI ratings on every pump.fun launch, wallet and X tracking, and one-click trading at 0% fees.
More free tools
Solana Bubble Map
Who holds a token, and which top holders are secretly the same person.
Solana Wallet Tracker
Follow any wallets and see every buy and sell they make.
Solana Rug Checker
Authorities, Token-2022 traps, holders and liquidity, scored 0-100.
pump.fun Tracker
Every new pump.fun launch, live, the second it is created.
Solana Whale Tracker
Large trades on any token, net whale flow, top buyers and dumpers.
Solana Memecoin Screener
Trending, new and boosted tokens filtered by liquidity, mcap and volume.
Solana PnL Tracker
Realized profit, open positions and win rate for any wallet.
Memecoin Alert Bot
New launches and graduations, filtered, in Telegram and Discord.
pump.fun MCP Server
Six read-only memecoin research tools for AI assistants.