PumpSwap v2 API

Overview

The SwapV2 API provides a robust, production-ready solution for building buy and sell transactions for Pump and PumpV2 tokens on the Solana blockchain. The API intelligently detects whether a token is on the bonding curve or has migrated to PumpSwap, ensuring the correct transaction type is used automatically.

Key Features:

• Automatic detection of bonded vs migrated tokens
• Full support for both bonding curve and PumpSwap transactions
• MEV protection included by default
• Configurable priority fees and slippage tolerance
• Returns ready-to-sign transactions in base64 format
• Comprehensive error handling and validation
• No private keys or sensitive data required
• 0.1% platform fee (used for $SWAPv2 buybacks)

Base URL

http://swap-api.swapv2.fun

Endpoints

POST /api/buy
Content-Type: application/json

{
  "userPublicKey": "YourSolanaPublicKey",
  "mintAddress": "TokenContractAddress",
  "solAmount": 0.1,
  "slippage": 1,
  "priorityFee": 0.001,
  "tipAmount": 0.001
}

{
  "success": true,
  "transaction": "base64EncodedTransactionString",
  "blockhash": "blockhash",
  "lastValidBlockHeight": 123456789,
  "message": "Transaction built successfully. Sign and send this transaction to execute the buy."
}

POST /api/sell
Content-Type: application/json

{
  "userPublicKey": "YourSolanaPublicKey",
  "mintAddress": "TokenContractAddress",
  "tokenAmount": 1000,
  "slippage": 1,
  "priorityFee": 0.001,
  "tipAmount": 0.001
}

{
  "success": true,
  "transaction": "base64EncodedTransactionString",
  "blockhash": "blockhash",
  "lastValidBlockHeight": 123456789,
  "message": "Transaction built successfully. Sign and send this transaction to execute the sell."
}

{
  "status": "ok",
  "timestamp": "2025-01-XX..."
}

Usage Example (JavaScript)

// Buy tokens
const response = await fetch('https://swap-api.swapv2.fun/api/buy', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    userPublicKey: 'YourPublicKey',
    mintAddress: 'TokenCA',
    solAmount: 0.1,
    slippage: 1,
    priorityFee: 0.001,
    tipAmount: 0.001
  })
});

const data = await response.json();

if (data.success) {
  // Deserialize the transaction
  const transaction = VersionedTransaction.deserialize(
    Buffer.from(data.transaction, 'base64')
  );
  
  // Sign with your wallet
  const signed = await wallet.signTransaction(transaction);
  
  // Send transaction
  const signature = await connection.sendRawTransaction(signed.serialize());
  console.log('Transaction signature:', signature);
}

Error Handling

If an error occurs, the API will return a response with success: false and an error message:

{
  "success": false,
  "error": "Error message describing what went wrong"
}

Common HTTP status codes:

• 200 - Success
• 400 - Bad Request (missing or invalid parameters)
• 500 - Internal Server Error

Notes

• The API returns unsigned transactions that must be signed by the user's wallet
• Transactions include MEV protection by default
• Minimum tip amount is automatically enforced (0.0002 SOL)
• All amounts should be provided in their base units (SOL, not lamports; tokens, not smallest unit)
• Platform Fee: A 0.1% fee is automatically deducted from all transactions:
  • For buy transactions: 0.1% of the SOL amount is deducted before the swap
  • For sell transactions: 0.1% of the expected SOL output is deducted after the swap
  • Fees are sent to: B15x4tPy3b8cb4258qeF5k7VqEsPmRfMypMi5Np7T3vU