Swap

Overview

The swap endpoint builds token swap transactions on Solana. You receive a serialized transaction that you sign and broadcast using your wallet.

This endpoint builds the transaction but does not execute it. You must sign and send the transaction yourself.

Supported Platforms

Pump.fun - Launch platform tokens
PumpSwap - Pump.fun liquidity pools
Orca - Concentrated liquidity
Meteora - Dynamic pools
Moonshot - New launches
Raydium - V4 AMM, CPMM, Launchpad
Jupiter - Aggregated routing

SDK Examples

import { SolanaTracker } from 'solana-swap';

const tracker = new SolanaTracker('YOUR_API_KEY', 'YOUR_PRIVATE_KEY');

// Basic swap
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112', // SOL
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: 0.1,
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS',
  priorityFee: 0.000005,
  txVersion: 'v0'
});

console.log('Transaction:', swap.txn);

Key Parameters

Amount Formats

The fromAmount parameter accepts:

Numeric: 1, 0.5 - Exact amount
Auto: "auto" - Entire wallet balance
Percentage: "50%", "25%" - Percentage of balance

Priority Fees

// Manual fee
{ priorityFee: 0.000005 }

// Automatic with level
{ 
  priorityFee: "auto",
  priorityFeeLevel: "high" // min, low, medium, high, veryHigh, unsafeMax
}

Custom Fees

Add your own fees for monetization:

{
  fee: "YOUR_WALLET:0.1", // 0.1% to your wallet
  feeType: "add" // or "deduct" (SOL only)
}

Examples

Swap with Auto Amount

// Swap entire balance
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112',
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: "auto",
  slippage: 15,
  payer: 'YOUR_WALLET_ADDRESS'
});

Swap with Percentage

// Swap 50% of balance
const swap = await tracker.swap({
  from: 'TOKEN_ADDRESS',
  to: 'So11111111111111111111111111111111111111112',
  fromAmount: "50%",
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS'
});

Swap with Custom Fee

// Add 0.1% fee
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112',
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: 1,
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS',
  fee: 'YOUR_FEE_WALLET:0.1',
  feeType: 'add'
});

Response Structure

{
  "txn": "BASE64_ENCODED_TRANSACTION",
  "rate": {
    "amountIn": 0.1,
    "amountOut": 81.631985,
    "minAmountOut": 73.4687865,
    "currentPrice": 0.012219167460548153,
    "executionPrice": 0.010997250714493338,
    "priceImpact": 0.002517,
    "fee": 0.000005,
    "platformFee": 9000000,
    "platformFeeUI": 0.009
  },
  "timeTaken": 0.016,
  "type": "v0"
}

Platform Fees

Standard fee: 0.5% of transaction value

Deducted from output
Shown in platformFee (lamports) and platformFeeUI (SOL)
Volume discounts available

Contact [email protected] for volume pricing

Common Errors

Error	Solution
Invalid token address	Verify addresses are valid
Invalid amount	Use number, “auto”, or percentage
Invalid slippage	Set between 0-100
Token has no pools	Token may be delisted
Insufficient liquidity	Try smaller amount

Next Steps

Rate Endpoint

Get quotes before swapping

JavaScript SDK

Install the SDK

Query Parameters

from

string

required

The base token address

Example:

"So11111111111111111111111111111111111111112"

string

required

The quote token address

Example:

"4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R"

fromAmount

required

The amount of the base token to swap. Accepts numeric value, 'auto' for full wallet balance, or percentage like '50%'

Example:

1

slippage

required

Maximum acceptable slippage percentage or 'auto' for dynamic slippage (Beta)

Required range: 0 <= x <= 100

Example:

10

payer

string

required

Public key of the wallet sending the transaction

Example:

"arsc4jbDnzaqcCLByyGo7fg7S2SmcFsWUzQuDtLZh2y"

priorityFee

Amount in SOL to increase transaction priority or 'auto'

Example:

0.000005

priorityFeeLevel

enum<string>

default:medium

Priority level when priorityFee is set to 'auto'

Available options:

min,

low,

medium,

high,

veryHigh,

unsafeMax

txVersion

enum<string>

default:v0

Transaction version

Available options:

v0,

legacy

fee

string

Custom fee for your users in format 'WALLET_ADDRESS:PERCENTAGE'

Example:

"arsc4jbDnzaqcCLByyGo7fg7S2SmcFsWUzQuDtLZh2y:0.1"

customTip

string

Custom tip for Jito or similar services in format 'WALLET_ADDRESS:SOL_AMOUNT'

feeType

enum<string>

default:add

Fee application type. 'deduct' option is only used when the from address is SOL

Available options:

add,

deduct

onlyDirectRoutes

boolean

default:false

Disable multi-hop swaps

Response

Successful swap transaction

txn

string

Base64 encoded transaction

Example:

"BASE64_TX"

rate

object

Show child attributes

rate.amountIn

number

Amount of input token

Example:

1

rate.amountOut

number

Amount of output token

Example:

81.631985

rate.minAmountOut

number

Minimum amount out after slippage

Example:

73.4687865

rate.currentPrice

number

Current market price

Example:

0.012219167460548153

rate.executionPrice

number

Actual execution price

Example:

0.010997250714493338

rate.priceImpact

number

Price impact as a decimal

Example:

0.002517

rate.fee

number

Transaction fee

Example:

0.000005

rate.baseCurrency

object

Show child attributes

rate.baseCurrency.mint

string

Base token mint address

rate.baseCurrency.decimals

integer

Base token decimals

rate.quoteCurrency

object

Show child attributes

rate.quoteCurrency.mint

string

Quote token mint address

rate.quoteCurrency.decimals

integer

Quote token decimals

rate.platformFee

integer

Platform fee in lamports

Example:

9000000

rate.platformFeeUI

number

Platform fee in SOL

Example:

0.009

timeTaken

number

Time taken for the operation in seconds

Example:

0.016

type

enum<string>

Transaction type

Available options:

v0,

legacy

Example:

"legacy"

Getting Started

API Reference

Overview

Supported Platforms

SDK Examples

Key Parameters

Amount Formats

Priority Fees

Custom Fees

Examples

Swap with Auto Amount

Swap with Percentage

Swap with Custom Fee

Response Structure

Platform Fees

Common Errors

Next Steps

Rate Endpoint

JavaScript SDK

Query Parameters

Response

Getting Started

API Reference

​Overview

​Supported Platforms

​SDK Examples

​Key Parameters

​Amount Formats

​Priority Fees

​Custom Fees

​Examples

​Swap with Auto Amount

​Swap with Percentage

​Swap with Custom Fee

​Response Structure

​Platform Fees

​Common Errors

​Next Steps

Rate Endpoint

JavaScript SDK

Query Parameters

Response

Overview

Supported Platforms

SDK Examples

Key Parameters

Amount Formats

Priority Fees

Custom Fees

Examples

Swap with Auto Amount

Swap with Percentage

Swap with Custom Fee

Response Structure

Platform Fees

Common Errors

Next Steps