documentation
Everything you need to use percolatorpump.
overview
percolatorpump is a two-phase Solana protocol. Phase 1 is a token launcher. Phase 2 is a leveraged perpetuals exchange where the memecoin itself is your collateral.
The protocol is powered by the open-source Percolator engine, originally designed by Anatoly Yakovenko (Toly). It enables up to 10x leverage on any Solana token without requiring stablecoins.
1. connect your wallet
Click the wallet button in the top-right corner of the nav bar. percolatorpump supports Phantom, Solflare, Backpack, and any Solana wallet that implements the Wallet Standard.
You need a small amount of SOL for transaction fees. All protocol interactions happen on-chain.
2. launch a ...perc token
Navigate to the Launch page. Fill in your token's name, ticker, description, and upload an image. Optionally set an initial buy (0-5 SOL) to seed your own token's liquidity on pump.fun.
When you submit, two transactions are built: a service fee transfer (if applicable) and a PumpPortal launch transaction. Your wallet will prompt you to sign both.
Every token launched through percolatorpump gets a vanity address ending in "perc". This suffix marks it as a percolatorpump-native token. When Phase 2 goes live, every ...perc token automatically gets its own leverage market.
After launch, you're redirected to a share page with your token's metadata, mint address, and a direct link to trade on pump.fun.
3. the treasury
Launch fees accumulate in a public treasury wallet. A live counter on the landing page shows the current balance.
When the treasury reaches 5 SOL, the Percolator trading engine deploys to mainnet and Phase 2 unlocks. This threshold funds the initial program deployment and the rent for the 15 seeded markets.
4. browse and create markets
The Markets page lists every active perpetuals market. Each market corresponds to a single SPL token and is backed by its own on-chain slab account.
15 top Solana memes are seeded at launch (TRUMP, PENGU, BONK, WIF, BOME, FARTCOIN, and more). Anyone can list additional tokens.
5. list a new market
Navigate to Markets > Add a Market. Paste any SPL token mint address and click Resolve. The system checks for on-chain metadata, verifies a DEX trading pool exists (Raydium, Meteora, or PumpSwap), and confirms no slab already exists for that mint.
Pricing tiers: the first 10 community-listed markets are free (rent only, approximately 0.7 SOL). After that, each listing costs 0.5 SOL plus rent.
You must provide an initial liquidity deposit in the token you're listing. This seeds the market so traders can open positions immediately. You become the initial liquidity provider.
The on-chain transaction allocates the slab account, creates the market header, initializes the engine with default risk parameters, creates the vault token account, and deposits your LP tokens. All in a single atomic transaction.
6. trade perps
Click into any market from the Markets page to open the trading UI. The left panel shows a live mark price chart. The right panel has the order form and your position details.
Select Long or Short, enter a size in tokens, set your leverage (1-10x), and adjust slippage tolerance. The panel previews your notional exposure, margin requirement, and current capital before you submit.
Orders execute against the on-chain Percolator engine. The engine uses the oracle price at transaction time, so your client-side slippage bounds act as a safety check.
7. manage positions
Your open position appears below the order panel on the perp page. It shows your side (long/short), basis, entry, current mark, capital, and matured PnL.
Use the Deposit and Withdraw buttons to add or remove collateral from your position. Use Close Position to exit entirely.
The Portfolio page aggregates all your positions across every market in one view.
8. market health and haircuts
Each market displays a health indicator (h). This measures the ratio of available vault funds to matured positive PnL across all positions.
When h is above 95%, the market is healthy and full withdrawals are available. Between 80-95%, partial socialization applies. Below 80%, withdrawals may be materially reduced. This is the Percolator engine's core risk-sharing mechanism.
The ABK badges show each side's mode: Open (normal trading), Close Only (drain mode, no new positions), or Paused (reset pending). These states activate automatically based on market conditions.
9. fees
Token launch: configurable, shown on the launch page before submission.
Market listing: free for the first 10 community listings, then 0.5 SOL per listing. Slab rent (~0.7 SOL) is always required.
Trading: a per-trade fee set in the engine's risk parameters. Visible in the on-chain slab details.
Solana network fees apply to all transactions (typically < 0.001 SOL).