Build a Swap Transaction

Build Swap Transaction

curl --request GET \
  --url https://swap-v2.solanatracker.io/swap

import requests

url = "https://swap-v2.solanatracker.io/swap"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://swap-v2.solanatracker.io/swap', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://swap-v2.solanatracker.io/swap",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://swap-v2.solanatracker.io/swap"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://swap-v2.solanatracker.io/swap")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://swap-v2.solanatracker.io/swap")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "txn": "BASE64_TX",
  "rate": {
    "amountIn": 1,
    "amountOut": 81.631985,
    "minAmountOut": 73.4687865,
    "currentPrice": 0.012219167460548153,
    "executionPrice": 0.010997250714493338,
    "priceImpact": 0.002517,
    "fee": 0.000005,
    "baseCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "quoteCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "platformFee": 9000000,
    "platformFeeUI": 0.009
  },
  "timeTaken": 0.016,
  "type": "legacy"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

GET

swap

Build Swap Transaction

curl --request GET \
  --url https://swap-v2.solanatracker.io/swap

import requests

url = "https://swap-v2.solanatracker.io/swap"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://swap-v2.solanatracker.io/swap', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://swap-v2.solanatracker.io/swap",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://swap-v2.solanatracker.io/swap"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://swap-v2.solanatracker.io/swap")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://swap-v2.solanatracker.io/swap")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "txn": "BASE64_TX",
  "rate": {
    "amountIn": 1,
    "amountOut": 81.631985,
    "minAmountOut": 73.4687865,
    "currentPrice": 0.012219167460548153,
    "executionPrice": 0.010997250714493338,
    "priceImpact": 0.002517,
    "fee": 0.000005,
    "baseCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "quoteCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "platformFee": 9000000,
    "platformFeeUI": 0.009
  },
  "timeTaken": 0.016,
  "type": "legacy"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

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);

In these SDK examples, slippage: 10 means 10%.

from solana_swap import SolanaTracker

tracker = SolanaTracker('YOUR_API_KEY', 'YOUR_PRIVATE_KEY')

# Basic swap
swap = tracker.swap(
    from_token='So11111111111111111111111111111111111111112',
    to_token='4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
    from_amount=0.1,
    slippage=10,
    payer='YOUR_WALLET_ADDRESS',
    priority_fee=0.000005,
    tx_version='v0'
)

print('Transaction:', swap['txn'])

curl -X GET "https://swap-v2.solanatracker.io/swap?from=So11111111111111111111111111111111111111112&to=4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R&fromAmount=0.1&slippage=10&payer=YOUR_WALLET_ADDRESS&priorityFee=0.000005&txVersion=v0"

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
}

Partner / Referral Fees

Add your own partner or referral 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'
});

Token Accounts and SOL Wrapping

The returned transaction already includes everything needed for the swap to land — you do not need to pre-create token accounts.

Associated Token Accounts (ATAs) are created automatically (idempotent) for the output token and any intermediate hop tokens when the payer wallet does not already have one. Rent (~0.00203 SOL per account) is paid by payer.
SOL wrapping/unwrapping is handled automatically: SOL is wrapped to wSOL when used as input, and any leftover wSOL is unwrapped back to native SOL when SOL is the output.

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"
}

Solana Tracker Platform Fees

Standard fee: 0.5% of transaction value

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

Contact swap-api@solanatracker.io 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'

Pattern: ^[a-zA-Z0-9]+:[0-9]+(\.[0-9]+)?$

Example:

"arsc4jbDnzaqcCLByyGo7fg7S2SmcFsWUzQuDtLZh2y:0.1"

customTip

string

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

Pattern: ^[a-zA-Z0-9]+:[0-9]+(\.[0-9]+)?$

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

timeTaken

number

Time taken for the operation in seconds

Example:

0.016

type

enum<string>

Transaction type

Available options:

v0,

legacy

Example:

"legacy"

⌘I

WebSocket Methods

Shredstream

Custom Methods

Account Methods

Block Methods

Transaction Methods

Network Methods

Stake Methods

Utility Methods

Resources

Overview

Supported Platforms

SDK Examples

Key Parameters

Amount Formats

Priority Fees

Partner / Referral Fees

Examples

Swap with Auto Amount

Swap with Percentage

Swap with Custom Fee

Token Accounts and SOL Wrapping

Response Structure

Solana Tracker Platform Fees

Common Errors

Next Steps

Rate Endpoint

JavaScript SDK

Query Parameters

Response

​Overview

​Supported Platforms

​SDK Examples

​Key Parameters

​Amount Formats

​Priority Fees

​Partner / Referral Fees

​Examples

​Swap with Auto Amount

​Swap with Percentage

​Swap with Custom Fee

​Token Accounts and SOL Wrapping

​Response Structure

​Solana Tracker Platform Fees

​Common Errors

​Next Steps

Rate Endpoint

JavaScript SDK

Query Parameters

Response

Overview

Supported Platforms

SDK Examples

Key Parameters

Amount Formats

Priority Fees

Partner / Referral Fees

Examples

Swap with Auto Amount

Swap with Percentage

Swap with Custom Fee

Token Accounts and SOL Wrapping

Response Structure

Solana Tracker Platform Fees

Common Errors

Next Steps