# Atomic Buy

> Use when the user wants to buy a pump.fun (or any Solana SPL) token via a Jito bundle, especially when the pump-sdk buy instruction is out of sync with the live program. Routes via Jupiter aggregator inside a Jito bundle for atomicity and front-running protection. Triggers on "buy a pump coin", "buy-jito", "jupiter buy via jito", "sniper buy", or any token purchase where atomicity matters.

- Skill: `nirholas/atomic-buy` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nirholas/atomic-buy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nirholas/atomic-buy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nirholas (https://skillmd.com/u/nirholas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nirholas/atomic-buy

---


# atomic-buy — Jupiter buy inside a Jito bundle

Buys a token using Jupiter as the router, wrapped in a Jito bundle so the buy + tip land atomically. Use this instead of pump-sdk's direct `buy` ix whenever the SDK is behind the live pump.fun program (e.g. the program added a `BuybackFeeRecipient` account and the local SDK doesn't include it).

## Script

`src/buy-jito.js`

## Setup

Run all commands from the repo root — `package.json` lives there and defines npm scripts (`npm run launch`, `npm run collect`, etc.).

```bash
npm install
cp .env.example .env  # fill in
```

## Flow

```bash
TARGET_MINT=<base58-mint-address> \
BUY_SOL=0.01 \
SLIPPAGE_BPS=500 \
FUNDER_SECRET=<base58> \
JITO_TIP=0.005 \
  npm run buy
```

`SLIPPAGE_BPS=500` = 5%. Lower it to 100–200 for stable pools, raise to 1000+ for fresh launches with extreme volatility.

## Env vars

- `RPC_URL` — Solana RPC. Jupiter quote uses its own endpoint, but tx submission goes through `RPC_URL` / Jito.
- `TARGET_MINT` — base58 mint address of the token to buy.
- `BUY_SOL` — amount of SOL to spend.
- `SLIPPAGE_BPS` — Jupiter slippage in basis points. 500 = 5%.
- `FUNDER_SECRET` — base58 secret of the wallet receiving the tokens and paying for the buy. (Despite the name, this is the buyer here, not a separate funder.)
- `JITO_TIP` — SOL, default 0.005.

## When to use vs pump-sdk direct buy

| Situation | Use |
|---|---|
| pump-sdk version matches live program | pump-sdk `buy` ix (cheaper, no Jupiter slippage) |
| pump-sdk lagging behind program upgrade | `buy-jito.js` (Jupiter) |
| Buying into a leaked/shared wallet | `buy-jito.js` + immediate `rescue-tokens.js` chain (see [[atomic-rescue]]) |
| Sniping at launch with MEV protection | `buy-jito.js` with high `JITO_TIP` |

## Gotchas

- **Token-2022 sweepers.** If the buyer wallet is leaked/shared, tokens land for ~3 s before a sweeper drains them. Chain with [[atomic-rescue]] (atomic buy-and-transfer) instead of buying to a leaked wallet directly.
- **Jupiter quote staleness.** Quote → tx build → bundle submit can take 1–2 s. On fresh-launch pools, the price can move past your slippage in that window. Either raise `SLIPPAGE_BPS` or accept some buy attempts will fail.
- **Jito tip floor.** 0.001 SOL is the documented floor but rarely lands during launches. Start at 0.005 and bump to 0.02+ for hot launches.
- **V2-USDC pools.** Buy routing changed for V2-USDC coins. Read `docs/v2-usdc-rollout/` before editing this script.

## Security

The buyer secret (`FUNDER_SECRET` here) holds the tokens after the buy. If that wallet is leaked, the tokens are gone within seconds of confirmation. Always buy to a wallet you control alone, or chain the buy with an atomic transfer ([[atomic-rescue]]).