Swap

Swap Token

POST /trade/local/swap

Create a local transaction to trade a token.

Body

Name	Type	Required	Description
action	"buy" | "sell"	Yes	buy or sell the token
mint	string	Yes	Contract address of token to trade
publicKey	string	Yes	bs58 public key of the wallet that is buying/selling
amount	number	Either amount OR percentage must be provided	Amount to buy/sell denominated by ccy field.
ccy	"sol" | "lamports" | "token" | "usd"	Yes IF amount is provided; No IF using percentage	Denomination for amount field (buy 1 sol, buy 1 usd, etc...)
percentage	number > 0 & <=100	Either amount OR percentage must be provided	Percentage of account to buy/sell (1 =1%, 10=10%). Buying 10% means spending 10% of sol in your wallet; Selling 10% means selling 10% of the tokens you own. There is a known bug when buying super high percentages due to fees. We have acknowledged this issue and are actively working on a fix. We recommend not buying more than 80%; Sells are unaffected you may sell 100% still.
slippage	number ≥ 0	No - defaults to 5	% tolerated slippage for transaction (10 = 10%, 1 = 1%. Recommended value is 5%.
priorityFee	number > 0.00001	No - defaults to 0.001	Priority Fee denominated in solana. The higher it is, the faster and higher success rate for the transaction is. You can get the optimal priority fee from Recommended Priority
pool	"pump" | "raydium" | "auto"	No - defaults to auto	The current pool the token is trading in. pump means it has not yet bonded, and raydium means it has. auto will determine for you using the Bonded endpoint. Providing the known pool will slightly increase response time.

Response

201

Serialized V0 Transaction as bytes.

Tutorial

TypeScript

import { Connection, Keypair, VersionedTransaction } from "@solana/web3.js";
import bs58 from "bs58";
import "dotenv/config";

// Initialize the connection to your rpc with a confirmation level of "confirmed"
const connection = new Connection(process.env.RPC_URL!, "confirmed");

// Initialize the keypair from a secret key or however you retrieve your wallet
const wallet = Keypair.fromSecretKey(bs58.decode(process.env.SECRET_KEY!));

async function localSwap() {
  const swapParams = {
    action: "buy", // buy or sell
    publicKey: wallet.publicKey.toBase58(), // We only send the public key to the server
    mint: "CzLSujWBLFsSjncfkh59rUFqvafWcY5tzedWJSuypump", // CA of the token
    amount: 0.1, // Amount of the token to swap
    ccy: "sol", // denomination of the amount
    priorityFee: 0.0001, // Priority fee for the swap
    slippage: 5, // Slippage tolerance for the swap, 5 = 5%
    pool: "auto", // pump, raydium, or auto (knowing the pool beforehand speeds up the swap)
  };

  const response = await fetch("https://api.pumplify.fun/trade/local/swap", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(swapParams),
  });

  // Check if the response succeeded
  if (!response.ok) {
    // If the response is not ok, print the error
    console.error("Swap failed:", await response.json());
    return;
  }

  // Get the array buffer from the response
  const serializedTxBuffer = await response.arrayBuffer();
  // Deserialize the transaction
  const tx = VersionedTransaction.deserialize(
    new Uint8Array(serializedTxBuffer)
  );
  // Sign the transaction with your wallet
  tx.sign([wallet]);

  // Send the signed transaction
  const signature = await connection.sendTransaction(tx);
  console.log("Solscan: https://solscan.io/tx/" + signature);
}

localSwap();